# Add a member to a room

Source: <https://everruns.com/docs/api/operations/add_room_member/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Sessions & workspaces](https://everruns.com/docs/api/groups/sessions-workspaces/)/Add a member to a room

# Add a member to a room

Preview

Add a person, an Everruns agent, an outside agent or a guest to a room. Owners and org admins only.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/rooms/{room_id}/members`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**room_id**

required

string

Prefixed public identifier

## Responses

200Success

### 200

Success

Media typeapplication/json

A member of a room.

object

**agent_id**

The agent’s id, for an Everruns agent.

string | null

**display_name**

required

Name shown with the member’s messages.

string

**handle**

required

Mention name, written `@handle`.

string

**id**

required

Prefixed member id (`rmem_...`).

string

**instructions**

Extra instructions an agent member gets in this room.

string | null

**joined_at**

required

When the member joined.

string format: date-time

**kind**

required

Person, Everruns agent, outside agent or guest.

string

Allowed values: person agent outside_agent guest

**left**

required

Whether the member left. Left members still name their old messages.

boolean

**role**

required

Owner or member.

string

Allowed values: owner member

**room_id**

required

The room this member belongs to.

string

**session_scope**

required

Which conversation an agent member keeps.

string

Allowed values: thread room

**user_id**

The person’s user id, for a person.

string | null

**wake**

required

When an agent member is woken.

string

Allowed values: mentions everything relevant never

### Example

```json
{
  "agent_id": "agent_01933b5a000070008000000000000005",
  "display_name": "Triage agent",
  "handle": "triage",
  "id": "rmem_01933b5a000070008000000000000003",
  "instructions": "Answer billing questions only.",
  "joined_at": "2026-11-10T15:04:05Z",
  "kind": "person",
  "left": false,
  "role": "owner",
  "room_id": "room_01933b5a000070008000000000000001",
  "session_scope": "thread",
  "user_id": "user_01933b5a000070008000000000000004",
  "wake": "mentions"
}
```

409Handle taken, or already a member

### 409

Handle taken, or already a member

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/rooms/example/members';
const options = {method: 'POST'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/rooms/example/members
```

Additional language examples require JavaScript. The default request example is available above.

200409

200 · Success

```json
{
  "agent_id": "agent_01933b5a000070008000000000000005",
  "display_name": "Triage agent",
  "handle": "triage",
  "id": "rmem_01933b5a000070008000000000000003",
  "instructions": "Answer billing questions only.",
  "joined_at": "2026-11-10T15:04:05Z",
  "kind": "person",
  "left": false,
  "role": "owner",
  "room_id": "room_01933b5a000070008000000000000001",
  "session_scope": "thread",
  "user_id": "user_01933b5a000070008000000000000004",
  "wake": "mentions"
}
```

409 · Handle taken, or already a member

No response body example is declared for this status.

## Matching endpoints