# Postman

Using Postman to invoke Symphony Messaging APIs allows you to quickly learn about the capabilities of Symphony Messaging's API suite as well as debug or troubleshoot any issues you may face when running bots or other integrations.

## Prerequisites

Before continuing, you will need the following:

* [Download and Install Postman](https://www.getpostman.com/downloads/)
* Your pod details:
  * Pod URL
  * Session Auth URL
  * Key Manager Auth URL
  * API Agent URL
* A generated [RSA key pair](/bots/authentication/rsa-authentication.md)
* A service account created on your pod with the public key from above loaded

## Symphony Messaging Postman Collection

Click on the button below to launch Postman with the Symphony Messaging REST APIs collection and a sample environment.

[![Run in Postman](https://run.pstmn.io/button.svg)](https://www.postman.com/symphony-devx/workspace/symphony/collection/15539217-e9bea678-8642-47da-adf7-a33c08c84b1d?ctx=documentation)

If the button above does not work for you, download the following archive containing the Symphony Messaging Rest APIs collection and a sample environment configuration.

1. [Download Collection and Environment Here](https://github.com/symphonyoss/symphony-api-spec/tree/master/postman)
2. Launch Postman
3. Click on the **Import** button on the top-left
4. Drop both json files into the import file window

![](/files/-MIu09Qq1RetIvkQolZ6)

## Update Environment Configuration

1. Click the gear button beside the environments selector dropdown
2. Select the sample Develop2 environment
3. Update the **Initial Value** column with your pod and bot details
4. Click the **Reset All** button to sync the **Current Value** column
5. Click **Update**, then close the manage environments dialog

![](/files/-MIu0N-_YRbwvH1CtG_Q)

## Run Collection

Try to perform Authentication > RSA Session Auth and RSA KeyMan Auth. If any of them fail, check that your environment details are accurate:

![](/files/-MIu0ZRxg0VamfHtZtZ_)

Explore the rest of the collection and make requests by filling in the respective request parameters or body payloads and pressing the Send button. There is no need to manually copy and paste tokens from the authentication process as they are saved in the environment. If the tokens expire, simply redo the requests from step 1 above and try again.

![](/files/-MIu0iZGD-50M302bD9A)


---

# 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/dev-tools/postman.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.