Get Async Completion
perplexity.get_async_completion
ActionAI & modelsconnection required
Calls the Perplexity API with the connection's credentials.
Fetch one async Sonar job by request id, returning its status and — once it has COMPLETED — the answer with its citations.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Perplexity
- Secret shape
- {"api_key": "…"}
- Config it needs
- base_url, default_model
- Resolved by
- config.connection_id, else node.connection_id
Configuration
1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
request_id The id returned by Perplexity: Start Async Completion. | string | Yes | — | — | {{ steps.start_research.id }} |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"request_id": "{{ steps.start_research.id }}"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id The async request id, used to fetch the result later. | string | — |
status CREATED, IN_PROGRESS, COMPLETED or FAILED. | string | — |
model The model the job runs. | string | — |
created_at When the job was submitted, as a Unix timestamp. | number | — |
started_at When the job began running, as a Unix timestamp. | number | — |
completed_at When the job finished, as a Unix timestamp. | number | — |
failed_at When the job failed, as a Unix timestamp. | number | — |
error_message Why the job failed; empty unless the status is FAILED. | string | — |
content The answer text, once the job has COMPLETED. | string | — |
citations Source URLs behind the finished answer. | array | — |
search_results The sources behind the finished answer. | array | — |
related_questions Suggested follow-up questions, when asked for. | array | — |
usage Token counts and the cost breakdown, once the job has COMPLETED. | object | — |
raw The untouched job object, for anything not shaped above. | object | — |
{
"citations": [],
"completed_at": 0,
"content": "",
"created_at": 0,
"error_message": "",
"failed_at": 0,
"id": "",
"model": "",
"raw": {},
"related_questions": [],
"search_results": [],
"started_at": 0,
"status": "",
"usage": {}
}Related Perplexity nodes
See Get Async Completion run in a workflow.
In a technical demo we add the Perplexity connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.