Skip to main content
GET
/
workspaces
/
{workspace_id}
/
agent
/
presets
/
{preset_id}
/
versions
/
{version_id}
Error
A valid request URL is required to generate request examples
{
  "model_name": "<string>",
  "model_provider": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "preset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "version": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "instructions": "<string>",
  "catalog_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "base_url": "<string>",
  "actions": [
    "<string>"
  ],
  "namespaces": [
    "<string>"
  ],
  "tool_approvals": {},
  "mcp_integrations": [
    "<string>"
  ],
  "agents": {
    "enabled": false,
    "subagents": [
      {
        "preset": "<string>",
        "preset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "preset_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "preset_version": 2,
        "name": "<string>",
        "description": "<string>",
        "max_turns": 2
      }
    ]
  },
  "retries": 3,
  "enable_thinking": true,
  "enable_internet_access": false,
  "capabilities": [],
  "subagent_eligibility": {
    "eligible": true,
    "reasons": [],
    "message": "<string>"
  },
  "skills": [
    {
      "skill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "skill_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "skill_name": "<string>",
      "skill_version": 123
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

​
fastapiusersauth
string
cookie
required

Path Parameters

​
preset_id
string<uuid>
required
​
version_id
string<uuid>
required
​
workspace_id
string<uuid>
required

Response

Successful Response

Full response model for an immutable preset version.

​
model_name
string
required
Maximum string length: 120
​
model_provider
string
required
Maximum string length: 120
​
id
string<uuid>
required
​
preset_id
string<uuid>
required
​
workspace_id
string<uuid>
required
​
version
integer
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
instructions
string | null
​
catalog_id
string<uuid> | null
​
base_url
string | null
Maximum string length: 500
​
output_type
Available options:
bool,
float,
int,
str,
list[bool],
list[float],
list[int],
list[str]
​
actions
string[] | null
​
namespaces
string[] | null
​
tool_approvals
Tool Approvals · object | null
​
mcp_integrations
string[] | null
​
agents
AgentSubagentsConfig · object

User-facing agents toggle and optional preset-backed subagents.

​
retries
integer
default:3
Required range: x >= 0
​
enable_thinking
boolean
default:true
​
enable_internet_access
boolean
default:false
​
capabilities
enum<string>[]
Available options:
approvals,
subagents,
internet_access
​
subagent_eligibility
AgentPresetSubagentEligibility · object

Whether a preset version can be attached as a preset-backed subagent.

​
skills
AgentPresetSkillBindingRead · object[]