Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Response

Agent detail

id
string<uuid>
agent_id
string

Unique slug identifier (lowercase, alphanumeric, hyphens)

Pattern: ^[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$
name
string
description
string
tools_config
object
cpus
string
default:1.0
mem_limit
string
default:1g
pids_limit
integer
default:200
soul_md
string
rules_md
string
autonomy_level
enum<string>
default:act_within_scope

Controls how much freedom the agent has when executing commands.

Available options:
ask_before_acting,
act_within_scope,
full_autonomy
status
enum<string>
Available options:
stopped,
running,
error
container_id
string | null
model_policy_id
string<uuid> | null

Internal policy reference used by backend model-router plumbing.

model_policy_name
string | null

Human-readable name of the model policy (resolved via JOIN).

models
string[]

User-facing model names assigned to this agent.

skills
object[]

Skills assigned to this agent.

container_profile_id
string<uuid> | null

FK to container_profiles table. Determines Docker image for the agent container.

container_profile
object | null

Resolved container profile object (from LEFT JOIN).

error_message
string | null
created_at
string<date-time>
updated_at
string<date-time>
created_by
string
principal_id
string<uuid>

Stable principal identifier (equals agent UUID). AI-115 workload principal model.

principal_type
enum<string>

Formal principal type. Always 'agent' for workload principals.

Available options:
agent