Skip to main content
POST
Get Execution
Use this API to fetch an execution document by ID. This is the polling endpoint: poll until execution.status !== "running". Set includeResults: true to also fetch the per-URL findings subcollection.

Endpoint

POST https://api.velt.dev/v2/agents/execution/get

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

1. Poll status only

2. Fetch with full results

Response

Success Response (execution document)

Execution document field reference:
The legacy execution-document fields knowledgeRetrieved / knowledgeCached / degraded have been removed. Memory-RAG runtime signals now live only on the in-memory execution result and are consumed internally by the guardrails processor; they are not persisted on the execution document.

Success Response (with results, includeResults: true)

When includeResults is true, a results array is included alongside execution:
Per-URL result fields: Finding fields (AgentFinding):

Failure Response

Errors: NOT_FOUND (Execution not found: {executionId} or Store database not found).