Get one of the caller's saved agents at its current or a named revision.

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

Archived agents are still readable. Another user's agent is 404.

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.

agentstringrequired

The saved agent's id (UUID). Handles are not accepted here.

Format uuid

Query parameters

revisionintegeroptional

Revision to read; defaults to the current one.

min 1

Responses

200The agent with the requested revision's name, description and config.
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
400revision is not a positive integer (INVALID_REVISION).
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
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 agent or revision for the caller (NOT_FOUND).
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