# Postman

Postman: collections, environments, workspaces, mocks, monitors, APIs. Exposes **43 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `postman_user_me` | Get authenticated user info - GET /me. |
| `postman_workspaces_list` | List workspaces - GET /workspaces. |
| `postman_workspace_get` | Get one workspace - GET /workspaces/{id}. |
| `postman_workspace_create` | Create a workspace - POST /workspaces. |
| `postman_workspace_update` | Update a workspace - PUT /workspaces/{id}. |
| `postman_workspace_delete` | Delete a workspace - DELETE /workspaces/{id}. |
| `postman_collections_list` | List collections - GET /collections. |
| `postman_collection_get` | Get one collection - GET /collections/{uid}. |
| `postman_collection_create` | Create a collection - POST /collections. |
| `postman_collection_update` | Update a collection - PUT /collections/{uid}. |
| `postman_collection_delete` | Delete a collection - DELETE /collections/{uid}. |
| `postman_environments_list` | List environments - GET /environments. |
| `postman_environment_get` | Get one environment - GET /environments/{uid}. |
| `postman_environment_create` | Create an environment - POST /environments. |
| `postman_environment_update` | Update an environment - PUT /environments/{uid}. |
| `postman_environment_delete` | Delete an environment - DELETE /environments/{uid}. |
| `postman_monitors_list` | List monitors - GET /monitors. |
| `postman_monitor_get` | Get one monitor - GET /monitors/{uid}. |
| `postman_monitor_create` | Create a monitor - POST /monitors. |
| `postman_monitor_update` | Update a monitor - PUT /monitors/{uid}. |
| `postman_monitor_delete` | Delete a monitor - DELETE /monitors/{uid}. |
| `postman_monitor_run` | Run a monitor now - POST /monitors/{uid}/run. |
| `postman_mocks_list` | List mocks - GET /mocks. |
| `postman_mock_get` | Get one mock - GET /mocks/{uid}. |
| `postman_mock_create` | Create a mock - POST /mocks. |
| `postman_mock_update` | Update a mock - PUT /mocks/{uid}. |
| `postman_mock_delete` | Delete a mock - DELETE /mocks/{uid}. |
| `postman_apis_list` | List APIs - GET /apis. |
| `postman_api_get` | Get one API - GET /apis/{uid}. |
| `postman_api_create` | Create an API - POST /apis. |
| `postman_api_update` | Update an API - PUT /apis/{uid}. |
| `postman_api_delete` | Delete an API - DELETE /apis/{uid}. |
| `postman_api_schemas_list` | List API schemas - GET /apis/{api_id}/schemas. |
| `postman_api_schema_get` | Get one API schema - GET /apis/{api_id}/schemas/{schema_id}. |
| `postman_api_schema_create` | Create an API schema - POST /apis/{api_id}/schemas. |
| `postman_api_schema_update` | Update an API schema - PUT /apis/{api_id}/schemas/{schema_id}. |
| `postman_api_schema_delete` | Delete an API schema - DELETE /apis/{api_id}/schemas/{schema_id}. |
| `postman_collection_folders_list` | List folders in a collection - GET /collections/{collection_id}/folders. |
| `postman_collection_requests_list` | List requests in a collection - GET /collections/{collection_id}/requests. |
| `postman_forks_list` | List collection forks - GET /collections/{collection_id}/forks. |
| `postman_fork_create` | Create a collection fork - POST /collections/{collection_id}/forks. |
| `postman_fork_delete` | Delete a collection fork - DELETE /collections/{collection_id}/forks/{fork_label}. |
| `postman_merge` | Merge a forked collection - POST /collections/{collection_id}/forks/{fork_label}/merge. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`POSTMAN_API_KEY`** - Postman - Settings - API keys. (https://go.postman.co/settings/me/api-keys)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `POSTMAN_API_KEY` | Postman - Settings - API keys. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Postman API documentation](https://learning.postman.com/docs/developer/postman-api/)