# Room API

{% hint style="warning" %}
Always use the ![](/files/m7sG1yMt1hKM9aixTWhz) **Copy** icon in the example field when copying examples. Manual copy and paste is known to cause data format errors.
{% endhint %}

### List an advisor's rooms

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v2/customer/rooms" method="get" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Create room

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v2/customer/rooms" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Rename room

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/rename" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Transfer room ownership to another advisor

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/ownership" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Remove room member

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v2/customer/rooms/{streamId}/members" method="delete" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Add room member

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v2/customer/rooms/{streamId}/members" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### List room members

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/members" method="get" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Update room member

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/members/{memberSymphonyId}" method="put" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Update room features

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/features" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Add room members in bulk

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v2/customer/rooms/members" method="post" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Update room activity

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/activity" method="put" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}

### Get the advisor's phone number / wa.me link to the WhatsApp Connect 1:1 with the advisor

{% openapi src="/files/8BmXoFudTsGXIjaZfgQc" path="/api/v1/customer/rooms/{streamId}/contact/{contactId}/empChannelConnector" method="get" %}
[api.yaml](https://4176899220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj4Xx1BendjNBmXW0Z5yP%2Fuploads%2Fgit-blob-fa1ba8693b2c3fa308a0fb506827c85606128ec0%2Fapi.yaml?alt=media)
{% endopenapi %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rest-api-federation.symphony.com/26.06/readme/room.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.