/
WA
warp
Search skmtc…
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
Agents
43
Networking
2
Scheduled Agents
7
get
/agent
List available agent skills
get
/agent/connected-self-hosted-workers
List connected self-hosted workers
get
/agent/runs/{runId}/transcript
Get run transcript
get
/agent/runs/{runId}/harness-usage
Get raw third-party harness usage
post
/agent/run
Run an agent task
get
/agent/runs
List agent runs
post
/agent/runs
Run a cloud agent
get
/agent/run-by-external-reference
Find the run that produced a given external reference URL
post
/agent/runs/batch-get
Get multiple runs by ID
get
/agent/runs/{runId}
Get run details
get
/agent/runs/{runId}/timeline
Get run timeline
get
/agent/runs/{runId}/diagnostics
Get run diagnostics
get
/agent/runs/{runId}/conversation
Get normalized run conversation
post
/agent/runs/{runId}/cancel
Cancel a run
post
/agent/runs/{runId}/followups
Submit a follow-up message for a run
post
/agent/runs/{runId}/interrupt
Interrupt the turn currently running on a run
get
/agent/runs/{runId}/handoff/attachments
List handoff snapshot attachments for a run
post
/agent/conversations/{conversation_id}/followups
Submit a follow-up message to the run behind a conversation
post
/agent/conversations/{conversation_id}/interrupt
Interrupt the turn running on the run behind a conversation
get
/agent/conversations/{conversation_id}
Get normalized conversation
get
/agent/conversations/{conversation_id}/transcript
Get conversation transcript
get
/agent/conversations/{conversation_id}/screenshots/{screenshot_uid}/download
Download a stored computer-use screenshot
get
/agent/environments
List environments
get
/agent/models
List available models
get
/agent/artifacts/{artifactUid}
Get artifact details
get
/agent/artifacts/{artifactUid}/download
Download an artifact
get
/agent/conversations/{conversationId}/block-snapshot
Download a conversation's block snapshot
get
/agent/identities
List agents
post
/agent/identities
Create an agent
get
/agent/identities/{uid}
Retrieve an agent
put
/agent/identities/{uid}
Update an agent
delete
/agent/identities/{uid}
Delete an agent
get
/agent/sessions/{sessionUuid}/redirect
Get session redirect
get
/agent/conversations/{conversationId}/redirect
Get conversation redirect
Factories
53
Agents
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Find the run that produced a given external reference URL
get
/agent/run-by-external-reference
Aug 15, 2026
a0daf9e59774
Revision changes
info
endpoint added