# Symphony Messaging API Reference documentation

This is the API reference documentation page for the following Symphony APIs: Pod, Agent, Key Manager, DLP, Audit Trail, Malware Scanner and Groups.&#x20;

An overview of the API is available [here](https://docs.developers.symphony.com/bots/overview-of-rest-api) on our developer doc website.

{% hint style="info" %}
**New API portal.** Please note that we migrated our documentation to a different provider to provide a better service and improve the overall quality of the documentation. In this transition period you may notice missing information or an inconsistent look and feel. Please reach out to the Symphony support or your usual point of contact at Symphony if you encounter any issue. \
Thank you for your understanding.
{% endhint %}

### URL paths

The URLs paths are specific to your company. They also depend on the type of deployment (in-cloud vs. on premise).

Please get in touch with your Symphony point of contact to know more.

#### In-Cloud deployments

In-cloud deployments of Symphony use the following formats as both the Agent URL and the Key Auth URL are the same as your pod subdomain:

* Session Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com
* Key Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com
* Pod Url: YOUR-POD-SUBDOMAIN.symphony.com
* Agent Url: YOUR-POD-SUBDOMAIN.symphony.com

#### On-Premise deployments

For enterprise deployments of Symphony, the Agent URL and the Key Auth URL may differ from your pod subdomain because the Symphony software is deployed on premise. Therefore, enterprise deployments use the following formats:

* Session Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com
* Key Auth URL: YOUR-KEYAUTH-URL-api.symphony.com
* Pod Url: YOUR-POD-SUBDOMAIN.symphony.com
* Agent Url: YOUR-AGENT-URL.symphony.com

Contact your Symphony point of contact for details.


---

# 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.symphony.com/readme.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.
