Rooms API

Group chat spaces with multiple Dyvas. Members join and leave themselves; there is no separate endpoint for adding another user to a room.

3 min read16 endpoints

Every route and HTTP method below was checked directly against the live ts-api source on August 13, 2026. Response bodies are illustrative examples, never captured responses.

Base URL

https://api.dyva.ai/v1

POST `/v1/rooms`

Create a room. At least one Dyva is required; you can't create an empty room and add characters later through this endpoint alone. You become the owner.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Request body (8)

namestringRequired: Display name for the room.
dyva_idsstring[]Required: At least one Dyva ID. Up to a fixed per-room maximum.
descriptionstringOptional: A short description of the room's purpose.
is_publicbooleanOptional: Defaults to true. Set false to make the room owner-only to join.
max_membersintegerOptional: Defaults to 10.
ai_interactionbooleanOptional: Whether Dyvas respond to messages at all. Defaults to true.
max_ai_responsesintegerOptional: How many Dyvas can respond to a single message.
categorystringOptional: Freeform category label.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "user_id": "usr_EXAMPLE0001",
  "name": "Strategy HQ",
  "slug": "strategy-hq",
  "description": "Brainstorm product strategy with the team.",
  "visibility": "public",
  "max_members": 10,
  "ai_interaction": true,
  "max_ai_responses": 2,
  "message_count": 0,
  "created_at": "2026-03-09T14:22:00Z",
  "member_count": 1,
  "dyva_count": 2,
  "dyvas": [
    {
      "id": "dyva_EXAMPLE0001",
      "name": "Atlas",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp"
    },
    {
      "id": "dyva_EXAMPLE0002",
      "name": "Nova",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0002.webp"
    }
  ]
}

Examples (1)

curl -X POST https://api.dyva.ai/v1/rooms \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Strategy HQ",
    "dyva_ids": ["dyva_EXAMPLE0001", "dyva_EXAMPLE0002"]
  }'

GET `/v1/rooms`

Public room directory, ranked by message count. Plain array, capped at 50 rooms, no pagination parameters. Use GET /v1/rooms/my for the rooms you actually belong to.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0001",
    "name": "Strategy HQ",
    "slug": "strategy-hq",
    "description": "Brainstorm product strategy with the team.",
    "visibility": "public",
    "max_members": 10,
    "message_count": 214,
    "member_count": 4,
    "dyva_count": 2,
    "created_at": "2026-03-09T14:22:00Z"
  }
]

GET `/v1/rooms/discover`

Searchable, filterable room directory with pagination and a message preview per room. This is the endpoint the in-app Rooms discovery page actually uses, not GET /v1/rooms.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (5)

qstringOptional: Matches room name and description.
categorystringOptional: Exact category match.
sortstringOptional: "popular" (default, by message count) or "newest".
limitintegerOptional: Defaults to 30, max 100.
offsetintegerOptional: Results to skip.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0002",
    "name": "Creative Lab",
    "slug": "creative-lab",
    "description": "Free-form ideation space.",
    "category": "creative",
    "message_count": 1042,
    "member_count": 12,
    "dyva_count": 3,
    "last_message_preview": "Let's push the packaging concept further.",
    "dyvas": [
      {
        "room_id": "room_EXAMPLE0002",
        "id": "dyva_EXAMPLE0003",
        "name": "Sage",
        "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0003.webp"
      }
    ]
  }
]

GET `/v1/rooms/my`

Rooms you own or are a member of, most recently active first. Capped at 50, no pagination parameters.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0001",
    "user_id": "usr_EXAMPLE0001",
    "name": "Strategy HQ",
    "slug": "strategy-hq",
    "visibility": "public",
    "message_count": 214,
    "member_count": 4,
    "dyva_count": 2,
    "last_message_at": "2026-03-09T15:08:33Z"
  }
]

GET `/v1/rooms/:id`

Full room detail: settings, members, and Dyvas. Accepts a room ID or slug.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "user_id": "usr_EXAMPLE0001",
  "name": "Strategy HQ",
  "slug": "strategy-hq",
  "description": "Brainstorm product strategy with the team.",
  "visibility": "public",
  "max_members": 10,
  "ai_interaction": true,
  "max_ai_responses": 2,
  "message_count": 214,
  "created_at": "2026-03-09T14:22:00Z",
  "members": [
    {
      "id": "usr_EXAMPLE0001",
      "display_name": "Jordan",
      "role": "owner",
      "joined_at": "2026-03-09T14:22:00Z"
    }
  ],
  "dyvas": [
    {
      "id": "dyva_EXAMPLE0001",
      "name": "Atlas",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
      "added_at": "2026-03-09T14:22:00Z"
    }
  ]
}

PATCH `/v1/rooms/:id`

Update room settings. Owner only. Every field is optional; omitted fields keep their current value.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (6)

namestringOptional: New display name.
descriptionstringOptional: New description.
ai_interactionbooleanOptional: Whether Dyvas respond to new messages.
max_ai_responsesintegerOptional: How many Dyvas can respond to one message.
max_membersintegerOptional: Member cap.
categorystringOptional: Freeform category label.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "name": "Strategy HQ v2",
  "description": "Refined product strategy sessions.",
  "visibility": "public",
  "max_members": 10,
  "updated_at": "2026-03-09T16:05:44Z"
}

DELETE `/v1/rooms/:id`

Delete a room and its messages. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

POST `/v1/rooms/:id/join`

Join a room as a member. Private rooms only allow the owner to join; everyone else gets a 403. Fails with a 400 once the room hits max_members.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "joined": true
}

POST `/v1/rooms/:id/leave`

Leave a room. Always succeeds, even if you weren't a member.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "left": true
}

GET `/v1/rooms/:id/members`

List a room's members. Plain array, no pagination.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "usr_EXAMPLE0001",
    "display_name": "Jordan",
    "username": "jordan",
    "role": "owner",
    "joined_at": "2026-03-09T14:22:00Z"
  },
  {
    "id": "usr_EXAMPLE0002",
    "display_name": "Sam",
    "username": "sam",
    "role": "member",
    "joined_at": "2026-03-09T14:45:00Z"
  }
]

GET `/v1/rooms/:id/messages`

Message history in chronological order (oldest first, despite the underlying query fetching newest-first and reversing). Supports limit and a before cursor; there is no offset parameter.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (3)

idstringRequired: The room's ID or its slug.
limitintegerOptional: Defaults to 50, max 100.
beforestringOptional: ISO 8601 timestamp. Only return messages created before this time.

Response

Illustrative example, not a captured response

[
  {
    "id": "rmsg_EXAMPLE0001",
    "room_id": "room_EXAMPLE0001",
    "role": "user",
    "user_id": "usr_EXAMPLE0001",
    "user_name": "Jordan",
    "dyva_id": null,
    "content": "What do you two think about our Q2 strategy?",
    "latency_ms": null,
    "created_at": "2026-03-09T15:07:45Z"
  },
  {
    "id": "rmsg_EXAMPLE0002",
    "room_id": "room_EXAMPLE0001",
    "role": "assistant",
    "user_id": null,
    "user_name": null,
    "dyva_id": "dyva_EXAMPLE0001",
    "dyva_name": "Atlas",
    "content": "I'd recommend we focus on retention over acquisition this quarter.",
    "latency_ms": 842,
    "created_at": "2026-03-09T15:08:33Z"
  }
]

POST `/v1/rooms/:id/messages`

Send a message. Room Dyvas may reply based on the room's ai_interaction and max_ai_responses settings. Set stream: true to receive Server-Sent Events instead of the JSON body below.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (2)

contentstringRequired: The message text. HTML tags are stripped before saving.
streambooleanOptional: When true, responds with an SSE stream of typing/token/ai_message/done events instead of JSON.

Response

Illustrative example, not a captured response

{
  "user_message": {
    "id": "rmsg_EXAMPLE0003",
    "room_id": "room_EXAMPLE0001",
    "role": "user",
    "user_id": "usr_EXAMPLE0001",
    "content": "Let's also discuss the partnership pipeline.",
    "created_at": "2026-03-09T15:12:09Z"
  },
  "ai_messages": [
    {
      "id": "rmsg_EXAMPLE0004",
      "room_id": "room_EXAMPLE0001",
      "role": "assistant",
      "dyva_id": "dyva_EXAMPLE0001",
      "dyva_name": "Atlas",
      "content": "Good call. I've tracked three potential partners from inbound this month.",
      "latency_ms": 1120,
      "created_at": "2026-03-09T15:12:11Z"
    }
  ]
}

DELETE `/v1/rooms/:id/messages/:msg_id`

Delete a message.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (2)

idstringRequired: The room's ID or its slug.
msg_idstringRequired: The message ID to delete.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

POST `/v1/rooms/:id/dyvas`

Add a Dyva to the room. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (1)

dyva_idstringRequired: The Dyva to add.

Response

Illustrative example, not a captured response

{
  "id": "dyva_EXAMPLE0003",
  "name": "Sage",
  "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0003.webp"
}

GET `/v1/rooms/:id/dyvas`

List a room's Dyvas.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "name": "Atlas",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "added_at": "2026-03-09T14:22:00Z"
  }
]

DELETE `/v1/rooms/:id/dyvas/:dyva_id`

Remove a Dyva from the room. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (2)

idstringRequired: The room's ID or its slug.
dyva_idstringRequired: The Dyva to remove.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

Browse the complete endpoint directory

Rooms API

Group chat spaces with multiple Dyvas. Members join and leave themselves; there is no separate endpoint for adding another user to a room.

3 min read16 endpoints

Every route and HTTP method below was checked directly against the live ts-api source on August 13, 2026. Response bodies are illustrative examples, never captured responses.

Base URL

https://api.dyva.ai/v1

POST `/v1/rooms`

Create a room. At least one Dyva is required; you can't create an empty room and add characters later through this endpoint alone. You become the owner.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Request body (8)

namestringRequired: Display name for the room.
dyva_idsstring[]Required: At least one Dyva ID. Up to a fixed per-room maximum.
descriptionstringOptional: A short description of the room's purpose.
is_publicbooleanOptional: Defaults to true. Set false to make the room owner-only to join.
max_membersintegerOptional: Defaults to 10.
ai_interactionbooleanOptional: Whether Dyvas respond to messages at all. Defaults to true.
max_ai_responsesintegerOptional: How many Dyvas can respond to a single message.
categorystringOptional: Freeform category label.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "user_id": "usr_EXAMPLE0001",
  "name": "Strategy HQ",
  "slug": "strategy-hq",
  "description": "Brainstorm product strategy with the team.",
  "visibility": "public",
  "max_members": 10,
  "ai_interaction": true,
  "max_ai_responses": 2,
  "message_count": 0,
  "created_at": "2026-03-09T14:22:00Z",
  "member_count": 1,
  "dyva_count": 2,
  "dyvas": [
    {
      "id": "dyva_EXAMPLE0001",
      "name": "Atlas",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp"
    },
    {
      "id": "dyva_EXAMPLE0002",
      "name": "Nova",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0002.webp"
    }
  ]
}

Examples (1)

curl -X POST https://api.dyva.ai/v1/rooms \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Strategy HQ",
    "dyva_ids": ["dyva_EXAMPLE0001", "dyva_EXAMPLE0002"]
  }'

GET `/v1/rooms`

Public room directory, ranked by message count. Plain array, capped at 50 rooms, no pagination parameters. Use GET /v1/rooms/my for the rooms you actually belong to.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0001",
    "name": "Strategy HQ",
    "slug": "strategy-hq",
    "description": "Brainstorm product strategy with the team.",
    "visibility": "public",
    "max_members": 10,
    "message_count": 214,
    "member_count": 4,
    "dyva_count": 2,
    "created_at": "2026-03-09T14:22:00Z"
  }
]

GET `/v1/rooms/discover`

Searchable, filterable room directory with pagination and a message preview per room. This is the endpoint the in-app Rooms discovery page actually uses, not GET /v1/rooms.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (5)

qstringOptional: Matches room name and description.
categorystringOptional: Exact category match.
sortstringOptional: "popular" (default, by message count) or "newest".
limitintegerOptional: Defaults to 30, max 100.
offsetintegerOptional: Results to skip.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0002",
    "name": "Creative Lab",
    "slug": "creative-lab",
    "description": "Free-form ideation space.",
    "category": "creative",
    "message_count": 1042,
    "member_count": 12,
    "dyva_count": 3,
    "last_message_preview": "Let's push the packaging concept further.",
    "dyvas": [
      {
        "room_id": "room_EXAMPLE0002",
        "id": "dyva_EXAMPLE0003",
        "name": "Sage",
        "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0003.webp"
      }
    ]
  }
]

GET `/v1/rooms/my`

Rooms you own or are a member of, most recently active first. Capped at 50, no pagination parameters.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "room_EXAMPLE0001",
    "user_id": "usr_EXAMPLE0001",
    "name": "Strategy HQ",
    "slug": "strategy-hq",
    "visibility": "public",
    "message_count": 214,
    "member_count": 4,
    "dyva_count": 2,
    "last_message_at": "2026-03-09T15:08:33Z"
  }
]

GET `/v1/rooms/:id`

Full room detail: settings, members, and Dyvas. Accepts a room ID or slug.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "user_id": "usr_EXAMPLE0001",
  "name": "Strategy HQ",
  "slug": "strategy-hq",
  "description": "Brainstorm product strategy with the team.",
  "visibility": "public",
  "max_members": 10,
  "ai_interaction": true,
  "max_ai_responses": 2,
  "message_count": 214,
  "created_at": "2026-03-09T14:22:00Z",
  "members": [
    {
      "id": "usr_EXAMPLE0001",
      "display_name": "Jordan",
      "role": "owner",
      "joined_at": "2026-03-09T14:22:00Z"
    }
  ],
  "dyvas": [
    {
      "id": "dyva_EXAMPLE0001",
      "name": "Atlas",
      "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
      "added_at": "2026-03-09T14:22:00Z"
    }
  ]
}

PATCH `/v1/rooms/:id`

Update room settings. Owner only. Every field is optional; omitted fields keep their current value.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (6)

namestringOptional: New display name.
descriptionstringOptional: New description.
ai_interactionbooleanOptional: Whether Dyvas respond to new messages.
max_ai_responsesintegerOptional: How many Dyvas can respond to one message.
max_membersintegerOptional: Member cap.
categorystringOptional: Freeform category label.

Response

Illustrative example, not a captured response

{
  "id": "room_EXAMPLE0001",
  "name": "Strategy HQ v2",
  "description": "Refined product strategy sessions.",
  "visibility": "public",
  "max_members": 10,
  "updated_at": "2026-03-09T16:05:44Z"
}

DELETE `/v1/rooms/:id`

Delete a room and its messages. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

POST `/v1/rooms/:id/join`

Join a room as a member. Private rooms only allow the owner to join; everyone else gets a 403. Fails with a 400 once the room hits max_members.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "joined": true
}

POST `/v1/rooms/:id/leave`

Leave a room. Always succeeds, even if you weren't a member.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

{
  "left": true
}

GET `/v1/rooms/:id/members`

List a room's members. Plain array, no pagination.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "usr_EXAMPLE0001",
    "display_name": "Jordan",
    "username": "jordan",
    "role": "owner",
    "joined_at": "2026-03-09T14:22:00Z"
  },
  {
    "id": "usr_EXAMPLE0002",
    "display_name": "Sam",
    "username": "sam",
    "role": "member",
    "joined_at": "2026-03-09T14:45:00Z"
  }
]

GET `/v1/rooms/:id/messages`

Message history in chronological order (oldest first, despite the underlying query fetching newest-first and reversing). Supports limit and a before cursor; there is no offset parameter.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (3)

idstringRequired: The room's ID or its slug.
limitintegerOptional: Defaults to 50, max 100.
beforestringOptional: ISO 8601 timestamp. Only return messages created before this time.

Response

Illustrative example, not a captured response

[
  {
    "id": "rmsg_EXAMPLE0001",
    "room_id": "room_EXAMPLE0001",
    "role": "user",
    "user_id": "usr_EXAMPLE0001",
    "user_name": "Jordan",
    "dyva_id": null,
    "content": "What do you two think about our Q2 strategy?",
    "latency_ms": null,
    "created_at": "2026-03-09T15:07:45Z"
  },
  {
    "id": "rmsg_EXAMPLE0002",
    "room_id": "room_EXAMPLE0001",
    "role": "assistant",
    "user_id": null,
    "user_name": null,
    "dyva_id": "dyva_EXAMPLE0001",
    "dyva_name": "Atlas",
    "content": "I'd recommend we focus on retention over acquisition this quarter.",
    "latency_ms": 842,
    "created_at": "2026-03-09T15:08:33Z"
  }
]

POST `/v1/rooms/:id/messages`

Send a message. Room Dyvas may reply based on the room's ai_interaction and max_ai_responses settings. Set stream: true to receive Server-Sent Events instead of the JSON body below.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (2)

contentstringRequired: The message text. HTML tags are stripped before saving.
streambooleanOptional: When true, responds with an SSE stream of typing/token/ai_message/done events instead of JSON.

Response

Illustrative example, not a captured response

{
  "user_message": {
    "id": "rmsg_EXAMPLE0003",
    "room_id": "room_EXAMPLE0001",
    "role": "user",
    "user_id": "usr_EXAMPLE0001",
    "content": "Let's also discuss the partnership pipeline.",
    "created_at": "2026-03-09T15:12:09Z"
  },
  "ai_messages": [
    {
      "id": "rmsg_EXAMPLE0004",
      "room_id": "room_EXAMPLE0001",
      "role": "assistant",
      "dyva_id": "dyva_EXAMPLE0001",
      "dyva_name": "Atlas",
      "content": "Good call. I've tracked three potential partners from inbound this month.",
      "latency_ms": 1120,
      "created_at": "2026-03-09T15:12:11Z"
    }
  ]
}

DELETE `/v1/rooms/:id/messages/:msg_id`

Delete a message.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (2)

idstringRequired: The room's ID or its slug.
msg_idstringRequired: The message ID to delete.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

POST `/v1/rooms/:id/dyvas`

Add a Dyva to the room. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Request body (1)

dyva_idstringRequired: The Dyva to add.

Response

Illustrative example, not a captured response

{
  "id": "dyva_EXAMPLE0003",
  "name": "Sage",
  "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0003.webp"
}

GET `/v1/rooms/:id/dyvas`

List a room's Dyvas.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The room's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "name": "Atlas",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "added_at": "2026-03-09T14:22:00Z"
  }
]

DELETE `/v1/rooms/:id/dyvas/:dyva_id`

Remove a Dyva from the room. Owner only.

Bearer token

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (2)

idstringRequired: The room's ID or its slug.
dyva_idstringRequired: The Dyva to remove.

Response

Illustrative example, not a captured response

HTTP/1.1 204 No Content

Browse the complete endpoint directory

POST /v1/rooms

GET /v1/rooms

GET /v1/rooms/discover

GET /v1/rooms/my

GET /v1/rooms/:id

PATCH /v1/rooms/:id

DELETE /v1/rooms/:id

POST /v1/rooms/:id/join

POST /v1/rooms/:id/leave

GET /v1/rooms/:id/members

GET /v1/rooms/:id/messages

POST /v1/rooms/:id/messages

DELETE /v1/rooms/:id/messages/:msg_id

POST /v1/rooms/:id/dyvas

GET /v1/rooms/:id/dyvas

DELETE /v1/rooms/:id/dyvas/:dyva_id

POST /v1/rooms

GET /v1/rooms

GET /v1/rooms/discover

GET /v1/rooms/my

GET /v1/rooms/:id

PATCH /v1/rooms/:id

DELETE /v1/rooms/:id

POST /v1/rooms/:id/join

POST /v1/rooms/:id/leave

GET /v1/rooms/:id/members

GET /v1/rooms/:id/messages

POST /v1/rooms/:id/messages

DELETE /v1/rooms/:id/messages/:msg_id

POST /v1/rooms/:id/dyvas

GET /v1/rooms/:id/dyvas

DELETE /v1/rooms/:id/dyvas/:dyva_id

POST `/v1/rooms`

GET `/v1/rooms`

GET `/v1/rooms/discover`

GET `/v1/rooms/my`

GET `/v1/rooms/:id`

PATCH `/v1/rooms/:id`

DELETE `/v1/rooms/:id`

POST `/v1/rooms/:id/join`

POST `/v1/rooms/:id/leave`

GET `/v1/rooms/:id/members`

GET `/v1/rooms/:id/messages`

POST `/v1/rooms/:id/messages`

DELETE `/v1/rooms/:id/messages/:msg_id`

POST `/v1/rooms/:id/dyvas`

GET `/v1/rooms/:id/dyvas`

DELETE `/v1/rooms/:id/dyvas/:dyva_id`

POST `/v1/rooms`

GET `/v1/rooms`

GET `/v1/rooms/discover`

GET `/v1/rooms/my`

GET `/v1/rooms/:id`

PATCH `/v1/rooms/:id`

DELETE `/v1/rooms/:id`

POST `/v1/rooms/:id/join`

POST `/v1/rooms/:id/leave`

GET `/v1/rooms/:id/members`

GET `/v1/rooms/:id/messages`

POST `/v1/rooms/:id/messages`

DELETE `/v1/rooms/:id/messages/:msg_id`

POST `/v1/rooms/:id/dyvas`

GET `/v1/rooms/:id/dyvas`

DELETE `/v1/rooms/:id/dyvas/:dyva_id`