A valid request URL is required to generate request examples{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "<string>",
"name": "<string>",
"description": "<string>",
"tools_config": {},
"cpus": "1.0",
"mem_limit": "1g",
"pids_limit": 200,
"soul_md": "<string>",
"rules_md": "<string>",
"autonomy_level": "act_within_scope",
"status": "stopped",
"status_verified": true,
"container_state": "running",
"container_id": "<string>",
"model_policy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"model_policy_name": "<string>",
"models": [
"<string>"
],
"skills": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"scope": "container_local",
"tools": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"install_method": "builtin"
}
]
}
],
"container_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"container_profile": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"docker_image": "<string>"
},
"error_message": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by": "<string>",
"principal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"principal_type": "agent"
}Create agent
Creates a new agent definition.
A valid request URL is required to generate request examples{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "<string>",
"name": "<string>",
"description": "<string>",
"tools_config": {},
"cpus": "1.0",
"mem_limit": "1g",
"pids_limit": 200,
"soul_md": "<string>",
"rules_md": "<string>",
"autonomy_level": "act_within_scope",
"status": "stopped",
"status_verified": true,
"container_state": "running",
"container_id": "<string>",
"model_policy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"model_policy_name": "<string>",
"models": [
"<string>"
],
"skills": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"scope": "container_local",
"tools": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"install_method": "builtin"
}
]
}
],
"container_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"container_profile": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"docker_image": "<string>"
},
"error_message": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by": "<string>",
"principal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"principal_type": "agent"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
^[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$Internal-only override. Prefer model_names for user-facing model assignment.
User-facing model names to assign directly to this agent (one or many).
Skill IDs to assign. Config is merged from all skills at save time (resolve-on-save).
Container profile to assign. Determines Docker image. Omit for default.
Controls agent autonomy. Defaults to act_within_scope.
ask_before_acting, act_within_scope, full_autonomy Response
Agent created
Unique slug identifier (lowercase, alphanumeric, hyphens)
^[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$Controls how much freedom the agent has when executing commands.
ask_before_acting, act_within_scope, full_autonomy unknown means reconciliation could not verify this agent against a real container — the API declines to report the last value the database recorded as though it were current (#238). It is not a state an agent is ever put INTO; it is the API declining to answer.
stopped, running, error, unknown False when status is unknown. Carried separately so a consumer can keep the distinction without string-matching on the status.
What the reconciler last SAW, as distinct from what the agent is recorded as (#239). absent means the container was not there at all — a 404 from the daemon, i.e. deleted rather than stopped — which is a different fact from exited. Null means the reconciler could not tell, and is NOT a synonym for absent.
running, created, restarting, paused, exited, dead, absent, null Internal policy reference used by backend model-router plumbing.
Human-readable name of the model policy (resolved via JOIN).
User-facing model names assigned to this agent.
Skills assigned to this agent.
Show child attributes
Show child attributes
FK to container_profiles table. Determines Docker image for the agent container.
Resolved container profile object (from LEFT JOIN).
Show child attributes
Show child attributes
Stable principal identifier (equals agent UUID). AI-115 workload principal model.
Formal principal type. Always 'agent' for workload principals.
agent