Agents

Agents represent registered AI agents within your tenant. Each agent has a unique identifier and metadata used for behavioral fingerprinting and filtering.

POST/v1/agents

Request body:

Field	Type	Required	Description
`agentId`	string	Yes	Unique identifier (1–128 chars, alphanumeric, hyphens, underscores)
`name`	string	Yes	Display name (1–256 chars)
`description`	string	No	Agent description (max 1024 chars)
`framework`	string	No	AI framework (e.g. `"langchain"`, `"crewai"`) (max 128 chars)
`environment`	string	No	Deployment environment (max 64 chars)
`integrationMode`	string	No	One of: `collector`, `sdk`, `http`, `sidecar`

Agent creation is subject to plan quotas. Free plans are limited to 1 agent; Pro plans allow more.

GET/v1/agents

List all registered agents.

GET/v1/agents/:id

Get a single agent by UUID.

Returns 404 if the agent does not exist or belongs to another tenant.

PATCH/v1/agents/:id

Update agent metadata. Only supplied fields are changed.

Request body: Same fields as POST, all optional.

GET/v1/agents/:id/sessions

List sessions for a specific agent.

Query parameters:

Param	Type	Default	Description
`limit`	number	20	Results per page (1–100)
`cursor`	string	—	Pagination cursor from `nextCursor`