Managed agents

Discover retained groups for an agent definition

Changed on

Accepts API-key and console-session authentication. Returns retained active and cancelled groups for the owned definition, including while new admission is disabled. Groups are ordered by creation time descending, then group ID descending. Each page is a consistent read-only snapshot. Newer groups are discovered by restarting from the first page. Listing does not grant admission entitlement, increase execution limits or reserve spending.

get/v1/agents/{id}/groups

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

Group ID from next_after. Must belong to the same tenant and agent definition.

limitinteger

Response

Retained groups in descending creation order

next_afterstring required

Use as after for the next page. Empty when no older groups remain.

Changes