# REST API

Version `1.0.0`

Servers: `https://agent.deepgram.com`, `https://api.deepgram.com`

## Operations

| Method | Path | Operation |
| --- | --- | --- |
| `GET` | `/v1/agent/settings/think/models` | [List Agent Think Models](./api/operations/models_list.md) |
| `POST` | `/v1/auth/grant` | [Token-based Authentication](./api/operations/tokens_grant.md) |
| `POST` | `/v1/listen` | [Transcribe and analyze pre-recorded audio and video](./api/operations/media_transcribe.md) |
| `GET` | `/v1/models` | [List Models](./api/operations/models_list_3.md) |
| `GET` | `/v1/models/{model_id}` | [Get a specific Model](./api/operations/models_get_2.md) |
| `GET` | `/v1/projects` | [List Projects](./api/operations/projects_list.md) |
| `DELETE` | `/v1/projects/{project_id}` | [Delete a Project](./api/operations/projects_delete.md) |
| `GET` | `/v1/projects/{project_id}` | [Get a Project](./api/operations/projects_get.md) |
| `PATCH` | `/v1/projects/{project_id}` | [Update a Project](./api/operations/projects_update.md) |
| `GET` | `/v1/projects/{project_id}/agent-variables` | [List Agent Variables](./api/operations/variables_list.md) |
| `POST` | `/v1/projects/{project_id}/agent-variables` | [Create an Agent Variable](./api/operations/variables_create.md) |
| `DELETE` | `/v1/projects/{project_id}/agent-variables/{variable_id}` | [Delete an Agent Variable](./api/operations/variables_delete.md) |
| `GET` | `/v1/projects/{project_id}/agent-variables/{variable_id}` | [Get an Agent Variable](./api/operations/variables_get.md) |
| `PATCH` | `/v1/projects/{project_id}/agent-variables/{variable_id}` | [Update an Agent Variable](./api/operations/variables_update.md) |
| `GET` | `/v1/projects/{project_id}/agents` | [List Agent Configurations](./api/operations/configurations_list.md) |
| `POST` | `/v1/projects/{project_id}/agents` | [Create an Agent Configuration](./api/operations/configurations_create.md) |
| `DELETE` | `/v1/projects/{project_id}/agents/{agent_id}` | [Delete an Agent Configuration](./api/operations/configurations_delete.md) |
| `GET` | `/v1/projects/{project_id}/agents/{agent_id}` | [Get an Agent Configuration](./api/operations/configurations_get.md) |
| `PUT` | `/v1/projects/{project_id}/agents/{agent_id}` | [Update Agent Metadata](./api/operations/configurations_update.md) |
| `GET` | `/v1/projects/{project_id}/balances` | [Get Project Balances](./api/operations/balances_list.md) |
| `GET` | `/v1/projects/{project_id}/balances/{balance_id}` | [Get a Project Balance](./api/operations/balances_get.md) |
| `GET` | `/v1/projects/{project_id}/billing/breakdown` | [Get Project Billing Breakdown](./api/operations/breakdown_list.md) |
| `GET` | `/v1/projects/{project_id}/billing/fields` | [List Project Billing Fields](./api/operations/fields_list_2.md) |
| `GET` | `/v1/projects/{project_id}/invites` | [List Project Invites](./api/operations/invites_list.md) |
| `POST` | `/v1/projects/{project_id}/invites` | [Create a Project Invite](./api/operations/invites_create.md) |
| `DELETE` | `/v1/projects/{project_id}/invites/{email}` | [Delete a Project Invite](./api/operations/invites_delete.md) |
| `GET` | `/v1/projects/{project_id}/keys` | [List Project Keys](./api/operations/keys_list.md) |
| `POST` | `/v1/projects/{project_id}/keys` | [Create a Project Key](./api/operations/keys_create.md) |
| `DELETE` | `/v1/projects/{project_id}/keys/{key_id}` | [Delete a Project Key](./api/operations/keys_delete.md) |
| `GET` | `/v1/projects/{project_id}/keys/{key_id}` | [Get a Project Key](./api/operations/keys_get.md) |
| `DELETE` | `/v1/projects/{project_id}/leave` | [Leave a Project](./api/operations/projects_leave.md) |
| `GET` | `/v1/projects/{project_id}/members` | [List Project Members](./api/operations/members_list.md) |
| `DELETE` | `/v1/projects/{project_id}/members/{member_id}` | [Delete a Project Member](./api/operations/members_delete.md) |
| `GET` | `/v1/projects/{project_id}/members/{member_id}/scopes` | [List Project Member Scopes](./api/operations/scopes_list.md) |
| `PUT` | `/v1/projects/{project_id}/members/{member_id}/scopes` | [Update Project Member Scopes](./api/operations/scopes_update.md) |
| `GET` | `/v1/projects/{project_id}/models` | [List Project Models](./api/operations/models_list_2.md) |
| `GET` | `/v1/projects/{project_id}/models/{model_id}` | [Get a Project Model](./api/operations/models_get.md) |
| `GET` | `/v1/projects/{project_id}/purchases` | [List Project Purchases](./api/operations/purchases_list.md) |
| `GET` | `/v1/projects/{project_id}/requests` | [List Project Requests](./api/operations/requests_list.md) |
| `GET` | `/v1/projects/{project_id}/requests/{request_id}` | [Get a Project Request](./api/operations/requests_get.md) |
| `GET` | `/v1/projects/{project_id}/self-hosted/distribution/credentials` | [List Project Self-Hosted Distribution Credentials](./api/operations/distributioncredentials_list.md) |
| `POST` | `/v1/projects/{project_id}/self-hosted/distribution/credentials` | [Create a Project Self-Hosted Distribution Credential](./api/operations/distributioncredentials_create.md) |
| `DELETE` | `/v1/projects/{project_id}/self-hosted/distribution/credentials/{distribution_credentials_id}` | [Delete a Project Self-Hosted Distribution Credential](./api/operations/distributioncredentials_delete.md) |
| `GET` | `/v1/projects/{project_id}/self-hosted/distribution/credentials/{distribution_credentials_id}` | [Get a Project Self-Hosted Distribution Credential](./api/operations/distributioncredentials_get.md) |
| `GET` | `/v1/projects/{project_id}/usage` | [Get Project Usage](./api/operations/usage_get.md) |
| `GET` | `/v1/projects/{project_id}/usage/breakdown` | [Get Project Usage Breakdown](./api/operations/breakdown_get.md) |
| `GET` | `/v1/projects/{project_id}/usage/fields` | [List Project Usage Fields](./api/operations/fields_list.md) |
| `POST` | `/v1/read` | [Analyze text content](./api/operations/text_analyze.md) |
| `POST` | `/v1/speak` | [Text to Speech transformation](./api/operations/audio_generate.md) |
| `POST` | `/v2/speak` | [Flux Text to Speech (batch)](./api/operations/audio_generate_2.md) |

## Related pages

- [Analyze text content](./api/operations/text_analyze.md)
- [audio](./api/operations/tags/audio.md)
- [balances](./api/operations/tags/balances.md)
- [breakdown](./api/operations/tags/breakdown.md)
- [configurations](./api/operations/tags/configurations.md)
- [Create a Project Invite](./api/operations/invites_create.md)
- [Create a Project Key](./api/operations/keys_create.md)
- [Create a Project Self-Hosted Distribution Credential](./api/operations/distributioncredentials_create.md)
- [Create an Agent Configuration](./api/operations/configurations_create.md)
- [Create an Agent Variable](./api/operations/variables_create.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.