Perplexity Agent API is one of 12 APIs that Perplexity publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Agent. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, pricing, and an AsyncAPI specification.
This API exposes
1 operation
across 1 path,
and defines 58 schemas.
It is described by OpenAPI 3.1.0, at version 1.0.0.
Requests are made against a single base URL, https://api.perplexity.ai.
1 operations1 paths58 schemas1 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.perplexity.ai
Authentication
HTTP Bearer
Resource Areas
1
Authentication & Security 1
Perplexity Agent API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (HTTPBearer).
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.
Agent 1
POST
/v1/agent
Create Agent Response
createAgentbody→ 200
Schemas 58
The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are ResponsesRequest (12 properties), ResponsesResponse (8 properties), FunctionCallOutputItem (7 properties), ResponsesCost (7 properties). Each schema is shown below with its type and property counts.
FunctionCallOutputInput
object
5 properties3 required
Input
Input content - either a string or array of input items
FinanceSearchTool
object
Finance search tool configuration for the Agent API
1 property1 required
FetchUrlQueriesEvent
object
URL fetch queries event (type: "response.reasoning.fetchurlqueries"). Contains URLs being fetched.
4 properties3 required
WebSearchFilters
Date
string
Input: MM/DD/YYYY, Output: YYYY-MM-DD
OutputItem
FunctionCallInput
object
5 properties4 required
ReasoningConfig
object
1 property
SearchDomainFilter
object
1 property
SearchQueriesEvent
object
Search queries event (type: "response.reasoning.searchqueries"). Contains search queries being executed.
4 properties3 required
ResponseCompletedEvent
object
Response event Contains the full or partial response object.
3 properties2 required
FetchUrlResultsOutputItem
object
2 properties2 required
OutputItemAddedEvent
object
Output item added event (type: "response.outputitem.added"). Emitted when a new output item (message or tool call) starts.
Output item done event (type: "response.outputitem.done"). Emitted when an output item (message or tool call) completes.
4 properties4 required
ResponseInProgressEvent
object
Response in progress event (type: "response.inprogress"). Emitted when response processing has started.
3 properties2 required
Tool
JSONSchemaFormat
object
Defines a JSON schema for structured output validation
4 properties2 required
InputContent
Message content - either a string or array of content parts
SearchRecencyFilter
string
Time-based recency filter for search results
MessageOutputItem
object
5 properties5 required
RoleType
string
Role in a message
Annotation
object
Text annotation (URL citation)
5 properties
ErrorInfo
object
Error information returned when a request fails
3 properties1 required
UrlContent
object
Content fetched from a URL
3 properties3 required
ContentPart
object
3 properties2 required
Currency
string
Currency code for cost values
DateFilters
object
5 properties
InputMessage
object
3 properties3 required
FunctionTool
object
5 properties2 required
InputContentPart
object
3 properties1 required
EventType
string
SSE event type discriminator
SearchSource
string
Source of search results
InputItem
ResponsesUsage
object
Token usage and cost information for a Responses API request
6 properties3 required
ResponseStreamEvent
SSE stream event. Discriminate by the type field: - response.created: Initial response object - response.inprogress: Response processing started - response.com…
