Chains

Get a continuation chain

Returns a single continuation chain. To read the generations in it, list generations filtered by chain_id.

get/v1/projects/{project_id}/chains/{chain_id}

Request

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

Path parameters

chain_idstring required
Example:chain_V1StGXR8Z5jdHi6B

Continuation chain ID

Response

Continuation chain

idstring
project_idstring
agent_idstring nullable

The agent whose continuation opened the chain. A chain can span agents, so this names its origin rather than an owner. Held as a plain id, not a reference the platform maintains — deleting the agent leaves the chain record intact.

status'active' | 'concluded' | 'expired' | 'budget_exhausted'

active — hops are still being spawned. concluded — a member finished with nothing left pending; not terminal, since a decision months later can spawn another hop and put the chain back to active. expired — a held approval lapsed and the agent does not react to expiry, so nothing resumed it. budget_exhausted — a hop was refused by the chain budget.

generation_countinteger

Generations in the chain, the root included — the same population GET /v1/projects/{project_id}/generations?chain_id=<id> returns. Re-derived on every hop, so it is a description of the chain, never the thing the budget is enforced against.

last_generation_atstring date-time nullable

When the chain last gained a generation

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": "chain_V1StGXR8Z5jdHi6B"
}

Changes

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