Chains

List continuation chains

Returns the continuation chains in a project, newest first. Filter by status to find the chains that may still be spending (active) or the ones a budget stopped (budget_exhausted).

get/v1/projects/{project_id}/chains

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/chains
  • 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 chain status. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400.

agent_idstring
Example:agent_V1StGXR8Z5jdHi6B

Filter by the agent whose continuation opened the chain

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 continuation chains

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "chain_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

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