docs.perplexity.ai

# Perplexity > Perplexity API documentation for building with the Agent API, the default for web-grounded AI and multi-provider applications, plus Search, Embeddings, and Sonar APIs. ## Docs - [Cancel Agent Response](https://docs.perplexity.ai/api-reference/agent-cancel-post.md): Requests cancellation of response `{id}`. Acts on durable state, so it works for background runs that outlive the client connection. Cancellation is asynchronous: a `200` acknowledges the request (`status: cancelling`) and the run stops shortly after - poll `GET /v1/agent/{id}` for its terminal stat… - [Download Agent Response File](https://docs.perplexity.ai/api-reference/agent-file-content-get.md): Download the raw bytes of a file the response delivered with the `share_file` tool. The `file_id` comes from the file list endpoint and is distinct from the response `id`. The response streams raw bytes, not JSON, with a `Content-Type` matching the file and a `Content-Disposition: attachment` header… - [List Agent Response Files](https://docs.perplexity.ai/api-reference/agent-files-get.md): List the files a response produced in the sandbox and delivered with the `share_file` tool. Scoped to the authenticated account, which only ever sees its own files. File content is not returned inline; download it with the file content endpoint. - [Retrieve Agent Response](https://docs.perplexity.ai/api-reference/agent-get.md): Retrieve a response created earlier. Returns a JSON snapshot of the response. Only responses created with `store` omitted or `true` can be retrieved; `store: false` responses return a 404. - [Create Agent Response](https://docs.perplexity.ai/api-reference/agent-post.md): Generate a response for the provided input with optional web search and reasoning. - [Get Async Chat Completion](https://docs.perplexity.ai/api-reference/async-sonar-api-request-get.md): Retrieve the response for a given asynchronous chat completion request. - [List Async Chat Completions](https://docs.perplexi

{ "openapi": "3.1.0", "info": { "title": "Perplexity AI API", "description": "Perplexity AI API", "version": "1.0.0" }, "servers": [ { "url": "https://api.perplexity.ai", "description": "Perplexity AI API" } ], "paths": { "/v1/sonar": { "post": { "summary": "Create Chat Completion", "description": "Generate a chat completion response for the given conversation.", "operationId": "chat_completions_chat_completions_post",