Managed agents

Observe retained lifecycle evidence and resource liability

Changed on

Requires authentication and an agent definition owned by the authenticated tenant. Returns 404 when the definition does not exist or belongs to another tenant. Returns one read-only database snapshot with a paginated run projection. Counts cover all runs of the definition. Missing timestamps and productive activity remain explicitly unmeasured. Available for retained work when new admission is disabled.

get/v1/agents/{id}/observations

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Query parameters

afterstring
limitinteger

Response

Success

schema_version'managed-agent-observations-v1' required

Version of these lifecycle observation semantics.

agent_idstring required
observed_atstring date-time required

Database observation time for this response. Subsequent pages can observe newer state.

productive_active_agentsunknown required
productive_active_agents_status'measurement_unavailable' required

Whether productive agent concurrency is independently measured.

next_afterstring required

Cursor for the next page in ascending run ID order, or an empty string. Each page has its own database snapshot.

Changes