# Overview of Pod API

## Symphony Messaging Pod APIs <img src="/files/-MJh8bBDxRnrzwVSGwvj" alt="" data-size="line">

The Symphony Messaging Pod API is used to build tools in order to manage and administer Symphony Messaging for your organization. The following guide includes API collections that exist on the Pod:

## Session Authenticate API <img src="/files/-MJh8dJszwD87ExJp6qu" alt="" data-size="line">

In order to access Pod API endpoints, bots must be authenticated with the Pod. To do so, a Bot must call the [Session Authenticate endpoint](https://developers.symphony.com/restapi/main/bot-authentication/rsa-session-authenticate).

If successful, the Pod API returns a Session Token which is valid for up to two weeks. This Session Token must be passed along with every subsequent Pod API request. You can read more about Authentication and Token management here:

{% content-ref url="/pages/-MB57YgIwHTbc0P1jRVR" %}
[Authentication](/bots/authentication.md)
{% endcontent-ref %}

## User APIs <img src="/files/-MJh8dJszwD87ExJp6qu" alt="" data-size="line">

The User APIs query and manage users on the Pod. These APIs can be used to do the following:

* Search users
* List all users
* Create users
* Update user information
* List user features
* Add/Remove user roles
* List user roles
* List user audit trail

The full list of Users API endpoints and their corresponding reference guide can be found at <https://developers.symphony.com/restapi/main/users> and <https://developers.symphony.com/restapi/main/user-management>.

## Stream APIs <img src="/files/-MJh8dJszwD87ExJp6qu" alt="" data-size="line">

The Stream APIs create and manage IMs and chat rooms. These APIs can be used to do the following:

* Create IM
* Create chatrooms
* Search for rooms
* Get room info
* Deactivate room
* List room members
* Add/Remove room members
* Promote/Demote user to room owner

The full list of Streams API endpoints and their corresponding reference guide can be found here: <https://developers.symphony.com/restapi/main/streams-conversations>

## Connection APIs <img src="/files/-MJh8dJszwD87ExJp6qu" alt="" data-size="line">

The Connection APIs manage user connections. These APIs can be used to do the following:

* Get connection
* List connections
* Create connections
* Accept connection
* Reject connection
* Remove connection

The full list of Connections API endpoints and their corresponding reference guide can be found here: <https://developers.symphony.com/restapi/main/connections>

## Presence APIs <img src="/files/-MJh8dJszwD87ExJp6qu" alt="" data-size="line">

The Presence APIs manage presence status for users. These APIs can be used to do the following:

* Get/Set user presence
* Get all users presence
* Register presence interest
* Create presence feed
* Read presence feed
* Delete presence feed

The full list of Presence API endpoints and their corresponding reference guide can be found here: <https://developers.symphony.com/restapi/main/presence>


---

# 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://docs.developers.symphony.com/bots/overview-of-rest-api/pod-api.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.
