9 available actions
What your AI agent can do in Perplexity AI
Perplexity AI provides conversational AI models for generating human-like text responses This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 9 actions.
Common starting points
- Get Async Chat CompletionGet Async Chat Completion (GET /v1/async/sonar/{id}).
- List Async Chat CompletionsList Async Chat Completions (GET /v1/async/sonar).
- Create Async Chat CompletionCreate Async Chat Completion (POST /v1/async/sonar).
- Create Chat CompletionPerplexity Sonar Chat Completions (POST /v1/sonar).
- Execute AgentCreate Agent Response (POST /v1/agent).
- Perplexity Search (Raw Results)Search the Web (POST /search).
Browse all 9 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 3 actions
- Get Async Chat CompletionGet Async Chat Completion (GET /v1/async/sonar/{id}).
- List Async Chat CompletionsList Async Chat Completions (GET /v1/async/sonar).
- List ModelsList Models (GET /v1/models).
Create & communicateCreate records or send supported messagesView 3 actions
- Create Async Chat CompletionCreate Async Chat Completion (POST /v1/async/sonar).
- Create Chat CompletionPerplexity Sonar Chat Completions (POST /v1/sonar).
- Create Contextualized EmbeddingsCreate Contextualized Embeddings (POST /v1/contextualizedembeddings).
Update & manageChange and manage existing recordsView 1 action
- Execute AgentCreate Agent Response (POST /v1/agent).
Other actionsSpecialist and administrative actions.View 2 actions
- CreateEmbeddingsGenerate vector embeddings for independent texts (queries, sentences, documents).
- Perplexity Search (Raw Results)Search the Web (POST /search).
Connection record
A connection you can control.
- Sign-in
- Customer-managed key
- Setup
- Use a key you create and control. It is stored securely and limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Perplexity AI
How does the agent connect to Perplexity AI?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Perplexity AI?
The page above lists the 9 actions currently available through the Perplexity AI connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Perplexity AI included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Perplexity AI is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Perplexity AI to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.