List the caller's saved agents, newest first.

GET/o/{org}/agents
View .md

Rows are the caller's own (user_id), not the org's: {org} only has to be one the caller belongs to. Fixed page size of 50. Archived agents are omitted unless include=archived.

Authenticate with a signed-in session token (an API key cannot call this route).

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

Query parameters

handlestringoptional

Exact handle filter (trimmed, lowercased before matching).

includestringoptional

archived adds archived agents; any other value is ignored.

One ofarchived
cursorstringoptional

Opaque next_cursor from a previous page. A malformed cursor is ignored (first page).

Responses

200One page of saved agents, each at its current revision.
profilesarray of SavedAgentrequired
12 item fields
idstringrequired
Format uuid
namestringrequired
handlestringrequired
descriptionstringrequired
harnessstringrequired

Launch-boundary managed harnesses.

One ofclaudecodexopencode
revisionintegerrequired
min 1
archivedbooleanrequired
sourceobject | object | nullrequired
configSavedAgentConfigrequired

The desired configuration stored with one revision.

10 fields
harnessstringrequired

Launch-boundary managed harnesses.

One ofclaudecodexopencode
catalog_revisionstringrequired
runtimeobject | objectrequired
1 fields
selectionstringrequired
defaultsobjectrequired
3 fields
modelSavedAgentModelrequired
2 fields
selectionstringrequired
idstringrequired

A model id the harness lists in GET /o/{org}/agents/available.

at most 200 characters
effortstring | nullrequired
speedstringrequired
One ofstandardfast
instructionsstringrequired
connection_refsarray of SavedAgentConnectionRefrequired
2 item fields
kindstringrequired
One ofoauthmcp
idstringrequired
capabilitiesobjectrequired
2 fields
browserbooleanrequired
computerbooleanrequired
toolsobject | objectrequired
1 fields
modestringrequired
networkobject | objectrequired
1 fields
modestringrequired
pluginsarray of objectrequired
1 item fields
catalog_idstringrequired
resolved_at_saveSavedAgentResolvedrequired

What the config resolved to against the catalog when this revision was saved.

9 fields
modelstringrequired
effortstring | nullrequired
speedstringrequired
One ofstandardfast
harness_versionstring | nullrequired
tool_idsarray of string | nullrequired
pluginsarray of objectrequired
3 item fields
catalog_idstringrequired
versionstringrequired
digeststringrequired
runtime_idstring | nullrequired
catalog_revisionstringrequired
pin_guaranteebooleanrequired
created_atstringrequired
Format date-time
updated_atstringrequired
Format date-time
next_cursorstring | nullrequired
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one that exists in an org the caller cannot see.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional