Create an agent and immutable version

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "name": "<string>",
  "system": "<string>",
  "built_in_integrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "default_credential_refs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "default_rubric": "<string>",
  "default_vault_ids": [
    "<string>"
  ],
  "description": "<string>",
  "disabled_integration_mcp_providers": [
    "<string>"
  ],
  "max_concurrent_sessions": 5000,
  "mcp_servers": [
    {}
  ],
  "metadata": {},
  "model_config": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ]
    }
  ],
  "skills": [
    {}
  ],
  "toolsets": [
    {
      "type": "evaluation"
    }
  ],
  "web_search_enabled": true
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/agents"

payload = {
    "model": "<string>",
    "name": "<string>",
    "system": "<string>",
    "built_in_integrations": [
        {
            "connection_id": "<string>",
            "tools": ["<string>"]
        }
    ],
    "default_credential_refs": [
        {
            "credential_id": "<string>",
            "vault_id": "<string>"
        }
    ],
    "default_rubric": "<string>",
    "default_vault_ids": ["<string>"],
    "description": "<string>",
    "disabled_integration_mcp_providers": ["<string>"],
    "max_concurrent_sessions": 5000,
    "mcp_servers": [{}],
    "metadata": {},
    "model_config": {
        "max_tokens": 0,
        "provider_params": {},
        "reasoning_effort": "<string>",
        "temperature": 123,
        "top_p": 123
    },
    "multiagent": {},
    "nativeIntegrations": [
        {
            "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "permission": "<string>",
            "resources": ["<string>"]
        }
    ],
    "skills": [{}],
    "toolsets": [{ "type": "evaluation" }],
    "web_search_enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    name: '<string>',
    system: '<string>',
    built_in_integrations: [{connection_id: '<string>', tools: ['<string>']}],
    default_credential_refs: [{credential_id: '<string>', vault_id: '<string>'}],
    default_rubric: '<string>',
    default_vault_ids: ['<string>'],
    description: '<string>',
    disabled_integration_mcp_providers: ['<string>'],
    max_concurrent_sessions: 5000,
    mcp_servers: [{}],
    metadata: {},
    model_config: {
      max_tokens: 0,
      provider_params: {},
      reasoning_effort: '<string>',
      temperature: 123,
      top_p: 123
    },
    multiagent: {},
    nativeIntegrations: [
      {
        connectionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        permission: '<string>',
        resources: ['<string>']
      }
    ],
    skills: [{}],
    toolsets: [{type: 'evaluation'}],
    web_search_enabled: true
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/agents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'name' => '<string>',
    'system' => '<string>',
    'built_in_integrations' => [
        [
                'connection_id' => '<string>',
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'default_credential_refs' => [
        [
                'credential_id' => '<string>',
                'vault_id' => '<string>'
        ]
    ],
    'default_rubric' => '<string>',
    'default_vault_ids' => [
        '<string>'
    ],
    'description' => '<string>',
    'disabled_integration_mcp_providers' => [
        '<string>'
    ],
    'max_concurrent_sessions' => 5000,
    'mcp_servers' => [
        [
                
        ]
    ],
    'metadata' => [
        
    ],
    'model_config' => [
        'max_tokens' => 0,
        'provider_params' => [
                
        ],
        'reasoning_effort' => '<string>',
        'temperature' => 123,
        'top_p' => 123
    ],
    'multiagent' => [
        
    ],
    'nativeIntegrations' => [
        [
                'connectionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'permission' => '<string>',
                'resources' => [
                                '<string>'
                ]
        ]
    ],
    'skills' => [
        [
                
        ]
    ],
    'toolsets' => [
        [
                'type' => 'evaluation'
        ]
    ],
    'web_search_enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/agents"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.recursion.labelbox.com/managed-agents/v1/agents")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/agents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "agent_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "default_credential_refs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "default_vault_ids": [
    "<string>"
  ],
  "disabled_integration_mcp_providers": [
    "<string>"
  ],
  "mcp_servers": [
    {}
  ],
  "model": "<string>",
  "model_config": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "name": "<string>",
  "organization_id": "<string>",
  "skills": [
    {}
  ],
  "system": "<string>",
  "tags": [
    {
      "color": "#14b8a6",
      "created_at": "2023-11-07T05:31:56Z",
      "label": "<string>",
      "organization_id": "<string>",
      "tag_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>"
    }
  ],
  "toolsets": [
    {
      "type": "evaluation"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z",
  "built_in_integrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "default_rubric": "<string>",
  "description": "<string>",
  "execution_compatibility": "compatible",
  "latest_agent_version_id": "<string>",
  "max_concurrent_sessions": 5000,
  "metadata": {},
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ]
    }
  ],
  "web_search_enabled": true
}

{
  "code": "invalid_json",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_conflict",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

POST

managed-agents

agents

Create an agent and immutable version

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "name": "<string>",
  "system": "<string>",
  "built_in_integrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "default_credential_refs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "default_rubric": "<string>",
  "default_vault_ids": [
    "<string>"
  ],
  "description": "<string>",
  "disabled_integration_mcp_providers": [
    "<string>"
  ],
  "max_concurrent_sessions": 5000,
  "mcp_servers": [
    {}
  ],
  "metadata": {},
  "model_config": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ]
    }
  ],
  "skills": [
    {}
  ],
  "toolsets": [
    {
      "type": "evaluation"
    }
  ],
  "web_search_enabled": true
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/agents"

payload = {
    "model": "<string>",
    "name": "<string>",
    "system": "<string>",
    "built_in_integrations": [
        {
            "connection_id": "<string>",
            "tools": ["<string>"]
        }
    ],
    "default_credential_refs": [
        {
            "credential_id": "<string>",
            "vault_id": "<string>"
        }
    ],
    "default_rubric": "<string>",
    "default_vault_ids": ["<string>"],
    "description": "<string>",
    "disabled_integration_mcp_providers": ["<string>"],
    "max_concurrent_sessions": 5000,
    "mcp_servers": [{}],
    "metadata": {},
    "model_config": {
        "max_tokens": 0,
        "provider_params": {},
        "reasoning_effort": "<string>",
        "temperature": 123,
        "top_p": 123
    },
    "multiagent": {},
    "nativeIntegrations": [
        {
            "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "permission": "<string>",
            "resources": ["<string>"]
        }
    ],
    "skills": [{}],
    "toolsets": [{ "type": "evaluation" }],
    "web_search_enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    name: '<string>',
    system: '<string>',
    built_in_integrations: [{connection_id: '<string>', tools: ['<string>']}],
    default_credential_refs: [{credential_id: '<string>', vault_id: '<string>'}],
    default_rubric: '<string>',
    default_vault_ids: ['<string>'],
    description: '<string>',
    disabled_integration_mcp_providers: ['<string>'],
    max_concurrent_sessions: 5000,
    mcp_servers: [{}],
    metadata: {},
    model_config: {
      max_tokens: 0,
      provider_params: {},
      reasoning_effort: '<string>',
      temperature: 123,
      top_p: 123
    },
    multiagent: {},
    nativeIntegrations: [
      {
        connectionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        permission: '<string>',
        resources: ['<string>']
      }
    ],
    skills: [{}],
    toolsets: [{type: 'evaluation'}],
    web_search_enabled: true
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/agents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'name' => '<string>',
    'system' => '<string>',
    'built_in_integrations' => [
        [
                'connection_id' => '<string>',
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'default_credential_refs' => [
        [
                'credential_id' => '<string>',
                'vault_id' => '<string>'
        ]
    ],
    'default_rubric' => '<string>',
    'default_vault_ids' => [
        '<string>'
    ],
    'description' => '<string>',
    'disabled_integration_mcp_providers' => [
        '<string>'
    ],
    'max_concurrent_sessions' => 5000,
    'mcp_servers' => [
        [
                
        ]
    ],
    'metadata' => [
        
    ],
    'model_config' => [
        'max_tokens' => 0,
        'provider_params' => [
                
        ],
        'reasoning_effort' => '<string>',
        'temperature' => 123,
        'top_p' => 123
    ],
    'multiagent' => [
        
    ],
    'nativeIntegrations' => [
        [
                'connectionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'permission' => '<string>',
                'resources' => [
                                '<string>'
                ]
        ]
    ],
    'skills' => [
        [
                
        ]
    ],
    'toolsets' => [
        [
                'type' => 'evaluation'
        ]
    ],
    'web_search_enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/agents"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.recursion.labelbox.com/managed-agents/v1/agents")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/agents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"built_in_integrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"default_credential_refs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"default_rubric\": \"<string>\",\n  \"default_vault_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabled_integration_mcp_providers\": [\n    \"<string>\"\n  ],\n  \"max_concurrent_sessions\": 5000,\n  \"mcp_servers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"model_config\": {\n    \"max_tokens\": 0,\n    \"provider_params\": {},\n    \"reasoning_effort\": \"<string>\",\n    \"temperature\": 123,\n    \"top_p\": 123\n  },\n  \"multiagent\": {},\n  \"nativeIntegrations\": [\n    {\n      \"connectionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"permission\": \"<string>\",\n      \"resources\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"toolsets\": [\n    {\n      \"type\": \"evaluation\"\n    }\n  ],\n  \"web_search_enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "agent_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "default_credential_refs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "default_vault_ids": [
    "<string>"
  ],
  "disabled_integration_mcp_providers": [
    "<string>"
  ],
  "mcp_servers": [
    {}
  ],
  "model": "<string>",
  "model_config": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "name": "<string>",
  "organization_id": "<string>",
  "skills": [
    {}
  ],
  "system": "<string>",
  "tags": [
    {
      "color": "#14b8a6",
      "created_at": "2023-11-07T05:31:56Z",
      "label": "<string>",
      "organization_id": "<string>",
      "tag_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>"
    }
  ],
  "toolsets": [
    {
      "type": "evaluation"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z",
  "built_in_integrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "default_rubric": "<string>",
  "description": "<string>",
  "execution_compatibility": "compatible",
  "latest_agent_version_id": "<string>",
  "max_concurrent_sessions": 5000,
  "metadata": {},
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ]
    }
  ],
  "web_search_enabled": true
}

{
  "code": "invalid_json",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_conflict",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Headers

Idempotency-Key

string

Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. For the legacy automation-run route only, the historical fingerprint ignores top-level JSON formatting and object-key order and removes the retired top-level idempotency_key field. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.

Required string length: 1 - 256

Pattern: ^[!-~]+$

x-tenant-id

string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1

x-organization-id

string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Body

application/json

Request body for creating a standalone Managed Agent: its system prompt, model, tool surface, and default vault grants. Sessions snapshot the agent version at start, so later edits do not change a running session.

model

string

required

Model id, copied verbatim from the models catalog, GET /managed-agents/v1/models (e.g. anthropic/claude-sonnet-4-5). Reads return the stored form, which adds a provider prefix before that id. An id the catalog does not list is rejected with the list of ids that it does.

name

string

required

Human-readable label for the agent. Required, and not blank; surrounding whitespace is trimmed.

system

string

required

System prompt for the agent.

built_in_integrations

object[]

Built-in integrations this agent may use, each naming an active organization connection an admin added on the Integrations page. Sessions receive short-lived access restricted to exactly those apps and each connection's tool allow-list; nothing is granted through a vault. Omit or send [] for none. Carried in full on every version write.

Maximum array length: 25

Show child attributes

default_credential_refs

object[]

Individual default items within default_vault_ids. The list is a whitelist across every default vault, not a filter within one, so it must name every item the agent should receive. Omit to select every current item; [] alongside a non-empty default_vault_ids is rejected because it would select none.

Show child attributes

default_rubric

null | string

Markdown rubric that sessions started from this agent are graded against when their create request omits an outcome. Must contain at least one gradeable criterion, written as markdown list items. A session that supplies its own outcome ignores this entirely.

default_vault_ids

string[]

Vaults granted by default when a session create request omits vault_ids. default_credential_refs may narrow their items.

description

string

Optional free-text note about what the agent is for. Not sent to the model.

disabled_integration_mcp_providers

string[]

Native integration providers whose MCP tools sessions of this agent do not receive even though the grant is present. The grant still authenticates the provider's sandbox tools where it has any (git and gh for GitHub); the agent's own mcp_servers are never affected. Omission differs by operation: on managedAgentsCreateAgent it defaults to ["github"] (new agents use gh and git in the sandbox); on managedAgentsCreateAgentVersion it means none, as for every other field there; send [] to receive every provider's MCP tools.

max_concurrent_sessions

null | integer

Maximum number of this agent's root sessions that may run or wait on compute at once. Omit for unlimited. Sessions beyond the cap are accepted with execution_state=queued and wait until a slot frees.

Required range: 1 <= x <= 10000

mcp_servers

object[]

Remote MCP servers whose tools are added to the agent's tool surface. Each entry is an object with name and url, e.g. {"name": "docs", "url": "https://example.com/mcp"}. Credentials come from the vaults granted to the session, and the discovered tool list is snapshotted at session start, so a later edit here does not change a running session.

Show child attributes

metadata

object

Free-form caller-owned JSON stored with the agent and returned on reads. Not interpreted by the service and never sent to the model.

Show child attributes

model_config

object

Default inference config applied to sessions started from this agent. Omit model_config or send {} to use provider defaults; null is invalid. reasoning_effort is normalized and validated for direct providers, and must exactly match the selected catalog model's supportedReasoningEfforts. An unsupported value, including any value for a catalog model that lists no exact options, returns 400; a model catalog that cannot be read to verify it returns 503.

Show child attributes

multiagent

object

Multiagent roster: the delegation targets this agent may hand work to, an optional advisor entry, and the interventionist posture. Snapshotted at session start; a child roster may tighten the recursion depth ceiling, never widen it.

Show child attributes

nativeIntegrations

object[]

Native connections this agent may use, with provider-enforced permission and resource restrictions. Omit or send [] for none. Stored in full on each agent version; secrets remain on the connection.

Maximum array length: 25

Show child attributes

skills

object[]

Skill declarations made available to the agent, passed through as given and snapshotted into the session at start. Capped at the 100 skills a session can carry.

Maximum array length: 100

Show child attributes

toolsets

object[]

Only the bare {type: evaluation} marker is supported, for evaluator agents. Omit or send [] for ordinary agents; built-in sandbox tools, MCP servers, and skills do not require a toolset.

Maximum array length: 1

Show child attributes

web_search_enabled

boolean

default:true

Whether sessions started from this agent may use the native web_search tool. Omit to enable it. The setting is snapshotted when a session starts.

Response

A configured standalone Managed Agent: its versioned execution definition plus current mutable classification tags. Publishing the execution definition mints a new immutable version; applying tags does not.

agent_id

string

required

Server-assigned id of the agent, used in the agent, agent-version, and session routes.

created_at

string<date-time>

required

Server-assigned RFC 3339 timestamp of when the agent was created.

default_credential_refs

object[] | null

required

Narrows the default vaults to individual credentials. Every credential is selected when a vault is first added, and may then be unchecked.

Show child attributes

default_vault_ids

string[] | null

required

Vaults whose credentials are copied into a new session when its create request omits vault_ids. Sending an explicit empty list on the session still overrides these.

disabled_integration_mcp_providers

string[] | null

required

Native integration providers whose MCP tools new sessions of this agent do not receive, even though the grant is present. The grant still authenticates the provider's sandbox tools where it has any (git and gh for GitHub). Suppresses integration-derived servers only, never the agent's own mcp_servers. New agents decline github by default when the field is omitted on create (JSON null counts as omitted); send an explicit [] on create to receive every provider's MCP tools. A version write carries the list in full: omitting it publishes a version with none.

mcp_servers

object[] | null

required

Remote MCP servers to attach. Each entry is an object with name (the label the server's tools are grouped under) and url (its http/https endpoint); any further keys are passed to the runtime unchanged. Credentials come from the vaults granted to the session, not from this entry. Tools are discovered and snapshotted at session start.

Show child attributes

model

string

required

Model the agent runs on. Pass a model id exactly as the models catalog (GET /managed-agents/v1/models) lists it, e.g. anthropic/claude-sonnet-4-5; reads return the stored form, which adds a provider prefix before that id. An explicitly provider-qualified string such as anthropic:claude-sonnet-4-5 selects that provider directly and is left as written. An id the catalog does not list is rejected here, not at the session's first turn.

model_config

object

required

Default inference settings applied to every turn unless a session overrides them.

Show child attributes

name

string

required

Human-readable label shown wherever agents are listed. Not required to be unique.

organization_id

string

required

Workspace organization that owns the agent. Server-assigned from the authenticated principal; never accepted from the caller.

skills

object[] | null

required

Skill packages loaded into the agent's runtime, each an entry with the skill reference and its metadata.

Show child attributes

system

string

required

System prompt prepended to every conversation this agent runs.

API reference

Endpoints

Create an agent and immutable version

Authorizations

Headers

Body

Response