a13nDocs
API referenceRuns

Get Run Agent

The frozen revision and effective configuration. Section reads are versioned fragments, never writable configs.

GET/api/v1/runs/{run_id}/agent

The frozen revision and effective configuration. Section reads are versioned fragments, never writable configs.

Authorization

AuthorizationBearer <token>

A workspace API key (a13n_...)

In: header

Path Parameters

run_id*Run Id

Query Parameters

view?string

Use compact for discovery; detailed preserves the original response.

Default"detailed"

Value in

  • "detailed"
  • "compact"
section?|null
part?Part
Default"all"

Value in

  • "all"
  • "model"
  • "model_settings"
  • "model_characteristics"
  • "summarize"
  • "instructions"
  • "toolsets"
  • "skills"
  • "skill_sync"
  • "connection_tools"
  • "tool_search"
  • "builtin_skills"
  • "client_tools"
  • "user_questions"
  • "subagent_mode"
  • "subagents"
  • "reviewer"
  • "media_understanding"
  • "plugins"
  • "output_spec"
  • "retries"
  • "default_environment_template_id"
  • "lazy_environment"
  • "memory_mounts"
  • "memory"
offset?Offset

Unicode code-point offset; continue with next_offset.

Range0 <= value
Default0
limit?Limit

Maximum Unicode code points in this fragment.

Range1 <= value <= 4000
Default4000
version?|

Content version from the first read; required after offset 0.

query?|

Case-sensitive literal text search.

Header Parameters

X-Workspace-ID?|

The workspace ID a login session acts in; required with a login session. An API key acts in its own workspace and needs none; naming another is forbidden.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/runs/string/agent"
{  "config": {    "background_compaction": {      "blocking_threshold": 0.95,      "enabled": false    },    "builtin_skills": [],    "client_tools": [],    "connection_tools": [],    "default_environment_template_id": "string",    "execution": {      "environment": {        "property1": "string",        "property2": "string"      },      "steering": "boundary",      "tools": {        "foreground_wait_seconds": 0,        "mode": "inline"      }    },    "instructions": "",    "lazy_environment": true,    "media_understanding": {      "audio": "string",      "image": "string",      "video": "string"    },    "memory": {      "enabled": false,      "spaces": []    },    "memory_mounts": [],    "model": "string",    "model_characteristics": {      "compact_threshold": 0.9,      "context_window_tokens": 1,      "proactive_context_management_threshold": 0.65    },    "model_settings": {      "property1": null,      "property2": null    },    "output_spec": {      "description": "string",      "name": "string",      "resources": {},      "schema": {        "property1": null,        "property2": null      },      "variants": [        {          "description": "string",          "name": "string",          "resources": {},          "schema": {            "property1": null,            "property2": null          }        },        {          "description": "string",          "name": "string",          "resources": {},          "schema": {            "property1": null,            "property2": null          }        }      ]    },    "plugins": [],    "retries": {      "output": 0,      "tools": 0    },    "reviewer": {      "instruction": "string",      "model": "string",      "model_settings": {        "property1": null,        "property2": null      },      "on_error": "deny",      "on_flagged": "deny",      "risk_threshold": "low",      "rules": {        "property1": {          "on_flagged": "deny",          "risk_threshold": "low"        },        "property2": {          "on_flagged": "deny",          "risk_threshold": "low"        }      },      "shell_instruction": "string",      "timeout_seconds": 120    },    "skill_sync": {      "cleanup": false,      "mode": "shared",      "overwrite": true    },    "skills": [],    "subagent_mode": "inline",    "subagents": {},    "summarize": false,    "tool_search": {      "config": {        "call_name": "call_tool",        "describe_name": "describe_tool",        "groups_name": "list_tool_groups",        "list_name": "list_tools",        "max_results": 10,        "max_search_bytes": 32768,        "mode": "proxy",        "search_name": "discover_tools"      },      "groups": {        "property1": {          "capabilities": [],          "connections": [],          "description": "string",          "platform": false,          "plugins": []        },        "property2": {          "capabilities": [],          "connections": [],          "description": "string",          "platform": false,          "plugins": []        }      }    },    "toolsets": {      "property1": {        "config": {          "property1": null,          "property2": null        },        "enabled": true,        "tools": {}      },      "property2": {        "config": {          "property1": null,          "property2": null        },        "enabled": true,        "tools": {}      }    },    "user_questions": false  },  "revision": {    "agent_id": "string",    "builtin_instructions": "string",    "config": {      "background_compaction": {        "blocking_threshold": 0.95,        "enabled": false      },      "builtin_skills": [],      "client_tools": [],      "connection_tools": [],      "default_environment_template_id": "string",      "execution": {        "environment": {          "property1": "string",          "property2": "string"        },        "steering": "boundary",        "tools": {          "foreground_wait_seconds": 0,          "mode": "inline"        }      },      "instructions": "",      "lazy_environment": true,      "media_understanding": {        "audio": "string",        "image": "string",        "video": "string"      },      "memory": {        "enabled": false,        "spaces": []      },      "memory_mounts": [],      "model": "string",      "model_characteristics": {        "compact_threshold": 0.9,        "context_window_tokens": 1,        "proactive_context_management_threshold": 0.65      },      "model_settings": {        "property1": null,        "property2": null      },      "output_spec": {        "description": "string",        "name": "string",        "resources": {},        "schema": {          "property1": null,          "property2": null        },        "variants": [          {            "description": "string",            "name": "string",            "resources": {},            "schema": {              "property1": null,              "property2": null            }          },          {            "description": "string",            "name": "string",            "resources": {},            "schema": {              "property1": null,              "property2": null            }          }        ]      },      "plugins": [],      "retries": {        "output": 0,        "tools": 0      },      "reviewer": {        "instruction": "string",        "model": "string",        "model_settings": {          "property1": null,          "property2": null        },        "on_error": "deny",        "on_flagged": "deny",        "risk_threshold": "low",        "rules": {          "property1": {            "on_flagged": "deny",            "risk_threshold": "low"          },          "property2": {            "on_flagged": "deny",            "risk_threshold": "low"          }        },        "shell_instruction": "string",        "timeout_seconds": 120      },      "skill_sync": {        "cleanup": false,        "mode": "shared",        "overwrite": true      },      "skills": [],      "subagent_mode": "inline",      "subagents": {},      "summarize": false,      "tool_search": {        "config": {          "call_name": "call_tool",          "describe_name": "describe_tool",          "groups_name": "list_tool_groups",          "list_name": "list_tools",          "max_results": 10,          "max_search_bytes": 32768,          "mode": "proxy",          "search_name": "discover_tools"        },        "groups": {          "property1": {            "capabilities": [],            "connections": [],            "description": "string",            "platform": false,            "plugins": []          },          "property2": {            "capabilities": [],            "connections": [],            "description": "string",            "platform": false,            "plugins": []          }        }      },      "toolsets": {        "property1": {          "config": {            "property1": null,            "property2": null          },          "enabled": true,          "tools": {}        },        "property2": {          "config": {            "property1": null,            "property2": null          },          "enabled": true,          "tools": {}        }      },      "user_questions": false    },    "created_at": "2019-08-24T14:15:22Z",    "created_by_id": "string",    "digest": "string",    "id": "string",    "note": "string",    "number": 0  }}