Dynamiq
Tracing

Ingest trace runs

Ingests a batch of workflow/flow/node trace runs, as produced by the Dynamiq Python SDK's TracingCallbackHandler / DynamiqTracingClient. The collector validates id, name, type, trace_id, source_id, start_time, end_time, and status; the remaining fields are stored as-is. SDK-emitted fields not listed in the schema (such as session_id and tags) are accepted and ignored by the collector.

POST
/v1/traces

Authorization

accessKey
AuthorizationBearer <token>

Organization or project Access Key created in the Dynamiq console. Valid only on synapse-served hosts: deployed app hostnames, knowledge base hostnames, the AI Gateway (router.*), and the traces collector (collector.*). Prefix dynamiq_acc_. NOT accepted by the management API (api.*). Send as Authorization: Bearer <access-key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/traces" \  -H "Content-Type: application/json" \  -d '{    "runs": [      {        "id": "11d4a6e8-9c2b-4f3a-8e1d-2f6071829301",        "name": "Workflow",        "type": "workflow",        "trace_id": "6e7f8091-a2b3-4c5d-8e6f-708192a3b4c5",        "source_id": "4f6e1c2a-7b8d-4e9f-a1b2-c3d4e5f60718",        "session_id": "3d3e8a1f-09a6-4f64-9d68-1d2f3a4b5c6d",        "start_time": "2026-06-10T09:15:21Z",        "end_time": "2026-06-10T09:15:34Z",        "status": "succeeded",        "input": {          "ticket_subject": "Charged twice for June invoice"        },        "output": {          "category": "billing"        },        "metadata": {          "workflow": {            "id": "2b3c4d5e-6f70-4182-93a4-b5c6d7e8f901",            "version": "3"          }        },        "executions": [],        "tags": [          "support-triage",          "production"        ]      }    ]  }'
{
  "message": "ok"
}
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}

Extract structured data from a document

Runs OCR on a PDF or image and then extracts structured data matching a JSON schema template. The `options` form field selects the OCR LLM, the structured-output LLM, and the extraction template. With `"stream": true` the response is an SSE stream instead of JSON.

List project traces

Lists execution traces across a project's apps, most recent first. Supports field filters on `started_at` (time) and `status` via query parameters of the form `started_at:gte=<RFC3339>` and `status=<value>`.