Skip to main content
GET
Get an agent

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

agentId
string
required

Response

The agent

GET /agents/{agentId}. Carries the hosted-agent configuration the list omits; never the access token.

id
string
name
string
identifier
string
kind
enum<string>
Available options:
byo,
hosted
harness
string | null

Hosted agents only. The agent runtime inside the sandbox.

model
string | null

Hosted agents only. The model override, or null for the provider's default.

instructions
string | null

Hosted agents only. The agent's standing brief.

imageUrl
string | null
channels
object[]
recentRequestAt
string<date-time> | null
workingInBackground
boolean
createdAt
string<date-time>