Traces

List traces

Returns a paginated list of execution traces for the project.

get/v1/projects/{project_id}/traces

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/traces
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

parent_trace_idstring
Example:trace_V1StGXR8Z5jdHi6B

Only the direct children of this trace. A trace naming nothing the caller can read matches nothing rather than widening the listing.

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of traces

totalinteger
limitinteger
offsetinteger

Example response

{
  "data": [
    {
      "id": "trace_V1StGXR8Z5jdHi6B",
      "file_id": "file_xyz789",
      "step_count": 2,
      "error": {
        "code": "AI_PROVIDER_ERROR",
        "message": "Provider returned 402: insufficient credits"
      },
      "content_redacted_by_principal_type": "user",
      "content_redacted_by_principal_id": "user_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.