Get the full trace timeline for a correlationId

Returns the timeline, automation summary, and error list for a given correlation id. Returns 404 when no events exist for that correlation id in the workspace.

Requires observability:read permission. Rate-limited to 100 calls per minute.

GET /v1/observability/{workspaceId}/traces/{correlationId}

Get the full trace timeline for a correlationId

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:ai-governance-v2/webhooks/v1/observability/{workspaceId}/traces/{correlationId} \
  --header 'Authorization: Bearer <token>'

200

{
  "correlationId": "<string>",
  "workspaceId": "<string>",
  "summary": {
    "eventCount": 123,
    "automationCount": 123,
    "errorCount": 123,
    "totalDurationMs": 123,
    "startTime": "2023-11-07T05:31:56Z",
    "endTime": "2023-11-07T05:31:56Z"
  },
  "user": {
    "id": "<string>",
    "sessionId": "<string>"
  },
  "timeline": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "offsetMs": 123,
      "type": "<string>",
      "automation": "<string>",
      "appInstance": "<string>",
      "duration": 123,
      "trigger": {
        "type": "<string>",
        "value": "<string>"
      },
      "error": {
        "code": "<string>",
        "message": "<string>"
      },
      "emittedEvent": "<string>"
    }
  ],
  "automations": [
    {
      "slug": "<string>",
      "duration": 123,
      "startOffset": 123
    }
  ],
  "errors": [
    {
      "automation": "<string>",
      "error": "<string>",
      "message": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

workspaceId · string · required

Workspace identifier.

Maximum string length: 64

Pattern: ^[a-zA-Z0-9_-]+$

correlationId · string · required

Correlation id of the trace to inspect.

Maximum string length: 128

Pattern: ^[a-zA-Z0-9_:-]+$

Response

200

application/json

Trace details.

correlationId · string

workspaceId · string

summary · object

Hide child attributes

summary. eventCount · integer

summary. automationCount · integer

summary. errorCount · integer

summary. totalDurationMs · integer

summary. startTime · string<date-time>

summary. endTime · string<date-time>

user · object

Hide child attributes

user. id · string | null

user. sessionId · string | null

timeline · object[]

Hide child attributes

timeline. timestamp · string<date-time>

timeline. offsetMs · integer

timeline. type · string

timeline. automation · string

timeline. appInstance · string

timeline. duration · integer

timeline. trigger · object

Hide child attributes

timeline.trigger. type · string

timeline.trigger. value · string

timeline. error · object

Hide child attributes

timeline.error. code · string

timeline.error. message · string

timeline. emittedEvent · string

automations · object[]

Hide child attributes

automations. slug · string

automations. duration · integer

automations. startOffset · integer

errors · object[]

Hide child attributes

errors. automation · string

errors. error · string

errors. message · string

errors. timestamp · string<date-time>