Approvals

List approval items

Returns approval items for a project, filterable by status, origin, and expiry.

get/v1/projects/{project_id}/approvals

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/approvals
  • 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

statusstring[]

Filter by lifecycle status. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400.

origin'node' | 'tool_call' | 'task_transition'

Filter by producer origin

expires_fromstring date-time

Only items whose expires_at is at or after this timestamp (ISO 8601)

expires_tostring date-time

Only items whose expires_at is at or before this timestamp (ISO 8601)

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 approval items

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "apr_V1StGXR8Z5jdHi6B",
      "previous_item_id": "apr_V1StGXR8Z5jdHi6B",
      "resolved_by_principal_type": "user",
      "resolved_by_principal_id": "user_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

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