Create a new immutable agent version

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "baseAgentVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "model": "<string>",
  "name": "<string>",
  "system": "<string>",
  "builtInIntegrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "defaultCredentialRefs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "defaultProjectId": "<string>",
  "defaultRubric": "<string>",
  "defaultVaultIds": [
    "<string>"
  ],
  "description": "<string>",
  "disabledIntegrationMcpProviders": [
    "<string>"
  ],
  "fileHistoryEnabled": true,
  "maxConcurrentSessions": 5000,
  "mcpServers": [
    {}
  ],
  "metadata": {},
  "modelConfig": {
    "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>"
      ],
      "tools": [
        "<string>"
      ]
    }
  ],
  "skills": [
    {}
  ],
  "webSearchEnabled": true
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions"

payload = {
    "baseAgentVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model": "<string>",
    "name": "<string>",
    "system": "<string>",
    "builtInIntegrations": [
        {
            "connection_id": "<string>",
            "tools": ["<string>"]
        }
    ],
    "defaultCredentialRefs": [
        {
            "credential_id": "<string>",
            "vault_id": "<string>"
        }
    ],
    "defaultProjectId": "<string>",
    "defaultRubric": "<string>",
    "defaultVaultIds": ["<string>"],
    "description": "<string>",
    "disabledIntegrationMcpProviders": ["<string>"],
    "fileHistoryEnabled": True,
    "maxConcurrentSessions": 5000,
    "mcpServers": [{}],
    "metadata": {},
    "modelConfig": {
        "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>"],
            "tools": ["<string>"]
        }
    ],
    "skills": [{}],
    "webSearchEnabled": 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({
    baseAgentVersionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    model: '<string>',
    name: '<string>',
    system: '<string>',
    builtInIntegrations: [{connection_id: '<string>', tools: ['<string>']}],
    defaultCredentialRefs: [{credential_id: '<string>', vault_id: '<string>'}],
    defaultProjectId: '<string>',
    defaultRubric: '<string>',
    defaultVaultIds: ['<string>'],
    description: '<string>',
    disabledIntegrationMcpProviders: ['<string>'],
    fileHistoryEnabled: true,
    maxConcurrentSessions: 5000,
    mcpServers: [{}],
    metadata: {},
    modelConfig: {
      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>'],
        tools: ['<string>']
      }
    ],
    skills: [{}],
    webSearchEnabled: true
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions', 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/v2/agents/{agentId}/versions",
  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([
    'baseAgentVersionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'model' => '<string>',
    'name' => '<string>',
    'system' => '<string>',
    'builtInIntegrations' => [
        [
                'connection_id' => '<string>',
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'defaultCredentialRefs' => [
        [
                'credential_id' => '<string>',
                'vault_id' => '<string>'
        ]
    ],
    'defaultProjectId' => '<string>',
    'defaultRubric' => '<string>',
    'defaultVaultIds' => [
        '<string>'
    ],
    'description' => '<string>',
    'disabledIntegrationMcpProviders' => [
        '<string>'
    ],
    'fileHistoryEnabled' => true,
    'maxConcurrentSessions' => 5000,
    'mcpServers' => [
        [
                
        ]
    ],
    'metadata' => [
        
    ],
    'modelConfig' => [
        '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>'
                ],
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'skills' => [
        [
                
        ]
    ],
    'webSearchEnabled' => 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/v2/agents/{agentId}/versions"

	payload := strings.NewReader("{\n  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": 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/v2/agents/{agentId}/versions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions")

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  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": true\n}"

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

{
  "agentId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "defaultCredentialRefs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "defaultVaultIds": [
    "<string>"
  ],
  "disabledIntegrationMcpProviders": [
    "<string>"
  ],
  "mcpServers": [
    {}
  ],
  "model": "<string>",
  "modelConfig": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "name": "<string>",
  "organizationId": "<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>"
    }
  ],
  "updatedAt": "2023-11-07T05:31:56Z",
  "builtInIntegrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "defaultProjectId": "<string>",
  "defaultRubric": "<string>",
  "description": "<string>",
  "executionCompatibility": "compatible",
  "fileHistoryEnabled": true,
  "latestAgentVersionId": "<string>",
  "maxConcurrentSessions": 5000,
  "metadata": {},
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ],
      "tools": [
        "<string>"
      ]
    }
  ],
  "supportsNewSessions": true,
  "template": {
    "id": "<string>",
    "revision": 0
  },
  "webSearchEnabled": 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": "revision_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": "managed_agents_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
  }
}

Agents

Create a new immutable agent version

Creates an immutable agent version from a full definition and atomically advances the agent’s latest pointer. baseAgentVersionId must equal the current latestAgentVersionId; otherwise the request returns 409 revision_conflict without creating a version. Omitted definition fields are cleared, not inherited. Tags change only through the agent tag routes. Invalid modelConfig, unsupported reasoning_effort, and invalid promptCacheTTL or promptCacheSharedTTL in modelConfig.provider_params return 400; an unavailable model catalog returns 503. The response contains the committed definition and latestAgentVersionId, with persisted createdAt and updatedAt timestamps. Repeating the same base after an ambiguous response creates no second version and returns 409 revision_conflict; re-read the agent to determine what committed.

POST

managed-agents

agents

{agentId}

versions

Create a new immutable agent version

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "baseAgentVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "model": "<string>",
  "name": "<string>",
  "system": "<string>",
  "builtInIntegrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "defaultCredentialRefs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "defaultProjectId": "<string>",
  "defaultRubric": "<string>",
  "defaultVaultIds": [
    "<string>"
  ],
  "description": "<string>",
  "disabledIntegrationMcpProviders": [
    "<string>"
  ],
  "fileHistoryEnabled": true,
  "maxConcurrentSessions": 5000,
  "mcpServers": [
    {}
  ],
  "metadata": {},
  "modelConfig": {
    "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>"
      ],
      "tools": [
        "<string>"
      ]
    }
  ],
  "skills": [
    {}
  ],
  "webSearchEnabled": true
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions"

payload = {
    "baseAgentVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model": "<string>",
    "name": "<string>",
    "system": "<string>",
    "builtInIntegrations": [
        {
            "connection_id": "<string>",
            "tools": ["<string>"]
        }
    ],
    "defaultCredentialRefs": [
        {
            "credential_id": "<string>",
            "vault_id": "<string>"
        }
    ],
    "defaultProjectId": "<string>",
    "defaultRubric": "<string>",
    "defaultVaultIds": ["<string>"],
    "description": "<string>",
    "disabledIntegrationMcpProviders": ["<string>"],
    "fileHistoryEnabled": True,
    "maxConcurrentSessions": 5000,
    "mcpServers": [{}],
    "metadata": {},
    "modelConfig": {
        "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>"],
            "tools": ["<string>"]
        }
    ],
    "skills": [{}],
    "webSearchEnabled": 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({
    baseAgentVersionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    model: '<string>',
    name: '<string>',
    system: '<string>',
    builtInIntegrations: [{connection_id: '<string>', tools: ['<string>']}],
    defaultCredentialRefs: [{credential_id: '<string>', vault_id: '<string>'}],
    defaultProjectId: '<string>',
    defaultRubric: '<string>',
    defaultVaultIds: ['<string>'],
    description: '<string>',
    disabledIntegrationMcpProviders: ['<string>'],
    fileHistoryEnabled: true,
    maxConcurrentSessions: 5000,
    mcpServers: [{}],
    metadata: {},
    modelConfig: {
      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>'],
        tools: ['<string>']
      }
    ],
    skills: [{}],
    webSearchEnabled: true
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions', 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/v2/agents/{agentId}/versions",
  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([
    'baseAgentVersionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'model' => '<string>',
    'name' => '<string>',
    'system' => '<string>',
    'builtInIntegrations' => [
        [
                'connection_id' => '<string>',
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'defaultCredentialRefs' => [
        [
                'credential_id' => '<string>',
                'vault_id' => '<string>'
        ]
    ],
    'defaultProjectId' => '<string>',
    'defaultRubric' => '<string>',
    'defaultVaultIds' => [
        '<string>'
    ],
    'description' => '<string>',
    'disabledIntegrationMcpProviders' => [
        '<string>'
    ],
    'fileHistoryEnabled' => true,
    'maxConcurrentSessions' => 5000,
    'mcpServers' => [
        [
                
        ]
    ],
    'metadata' => [
        
    ],
    'modelConfig' => [
        '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>'
                ],
                'tools' => [
                                '<string>'
                ]
        ]
    ],
    'skills' => [
        [
                
        ]
    ],
    'webSearchEnabled' => 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/v2/agents/{agentId}/versions"

	payload := strings.NewReader("{\n  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": 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/v2/agents/{agentId}/versions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v2/agents/{agentId}/versions")

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  \"baseAgentVersionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"<string>\",\n  \"name\": \"<string>\",\n  \"system\": \"<string>\",\n  \"builtInIntegrations\": [\n    {\n      \"connection_id\": \"<string>\",\n      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"defaultCredentialRefs\": [\n    {\n      \"credential_id\": \"<string>\",\n      \"vault_id\": \"<string>\"\n    }\n  ],\n  \"defaultProjectId\": \"<string>\",\n  \"defaultRubric\": \"<string>\",\n  \"defaultVaultIds\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"disabledIntegrationMcpProviders\": [\n    \"<string>\"\n  ],\n  \"fileHistoryEnabled\": true,\n  \"maxConcurrentSessions\": 5000,\n  \"mcpServers\": [\n    {}\n  ],\n  \"metadata\": {},\n  \"modelConfig\": {\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      \"tools\": [\n        \"<string>\"\n      ]\n    }\n  ],\n  \"skills\": [\n    {}\n  ],\n  \"webSearchEnabled\": true\n}"

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

{
  "agentId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "defaultCredentialRefs": [
    {
      "credential_id": "<string>",
      "vault_id": "<string>"
    }
  ],
  "defaultVaultIds": [
    "<string>"
  ],
  "disabledIntegrationMcpProviders": [
    "<string>"
  ],
  "mcpServers": [
    {}
  ],
  "model": "<string>",
  "modelConfig": {
    "max_tokens": 0,
    "provider_params": {},
    "reasoning_effort": "<string>",
    "temperature": 123,
    "top_p": 123
  },
  "name": "<string>",
  "organizationId": "<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>"
    }
  ],
  "updatedAt": "2023-11-07T05:31:56Z",
  "builtInIntegrations": [
    {
      "connection_id": "<string>",
      "tools": [
        "<string>"
      ]
    }
  ],
  "defaultProjectId": "<string>",
  "defaultRubric": "<string>",
  "description": "<string>",
  "executionCompatibility": "compatible",
  "fileHistoryEnabled": true,
  "latestAgentVersionId": "<string>",
  "maxConcurrentSessions": 5000,
  "metadata": {},
  "multiagent": {},
  "nativeIntegrations": [
    {
      "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permission": "<string>",
      "resources": [
        "<string>"
      ],
      "tools": [
        "<string>"
      ]
    }
  ],
  "supportsNewSessions": true,
  "template": {
    "id": "<string>",
    "revision": 0
  },
  "webSearchEnabled": 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": "revision_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": "managed_agents_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

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

Path Parameters

agentId

string<uuid>

required

Agent id (UUID) as returned by managedAgentsCreateAgent or managedAgentsListAgents.

Body

application/json

Request body for creating a new immutable standalone Managed Agent version. Every field is full content; omitted fields are cleared. baseAgentVersionId must name the current version or the request is rejected with revision_conflict.

baseAgentVersionId

string<uuid>

required

write-only

The agent's current latestAgentVersionId, as returned by managedAgentsGetAgent. Rejected with 409 revision_conflict if it is not the agent's current version, whether stale or unknown.

model

string

required

Public model id copied from GET /managed-agents/v1/models (for example anthropic/claude-sonnet-5-5). Agent reads return the same public id. An id the catalog does not list is rejected with a list of available public ids.

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.

builtInIntegrations

object[]

Built-in integrations this agent may use, each naming an active organization connection an admin added on the Integrations page. A non-empty tools list narrows this agent below the connection's organization allow-list; omission inherits it. Sessions receive short-lived access restricted to the effective tools; nothing is granted through a vault. Omit or send [] for no connections. Carried in full on every version write.

Maximum array length: 25

Show child attributes

defaultCredentialRefs

object[]

Individual default items within defaultVaultIds. 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 item the default vaults hold when the agent is saved. The selection is stored with the agent version, so a credential added to one of those vaults later is not included until the agent is saved again with it selected. [] alongside a non-empty defaultVaultIds is rejected because it would select none.

Show child attributes

defaultProjectId

null | string

Billing project copied into sessions started from this agent when their create request omits project_id. A non-empty session project_id overrides it. Accepted only on a model that GET /managed-agents/v1/models marks requiresProject; refused with 400 for an organization whose model list has no such model.

defaultRubric

null | string

Markdown rubric; each list item is one criterion. When set, every session of this agent that starts with a message is graded against it by default, with that message as the objective. Must contain at least one gradeable markdown list item. An explicit session outcome overrides the default.

defaultVaultIds

string[]

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

description

string

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

disabledIntegrationMcpProviders

string[]

Native integration providers whose MCP tools sessions of this agent do not receive even though the grant is present; the agent's own mcpServers are never affected. github is accepted but ignored, because a GitHub grant always keeps its MCP tools alongside git and gh in the sandbox. Omitting the field means none, on managedAgentsCreateAgent as on managedAgentsCreateAgentVersion.

fileHistoryEnabled

null | boolean

Whether sessions started from this agent may search and read the session outputs its earlier sessions saved, with search_agent_files and read_agent_file. Omit or send null to leave it off. Checked again on every search and read, so turning it off takes effect at once.

maxConcurrentSessions

null | integer

Maximum number of this agent's ordinary 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; child/subagent sessions and outcome evaluation passes do not take a slot. Carried in full on every version write: omitting it publishes a version with no cap.

Required range: 1 <= x <= 10000

mcpServers

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

modelConfig

object

Default inference config applied to sessions started from this agent. Omit modelConfig 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 reasoning_effort, including any value for a catalog model that lists no exact options, returns 400. Authored provider_params.thinking objects are validated. When prompt caching is enabled, invalid provider_params.promptCacheTTL or provider_params.promptCacheSharedTTL values, incompatible models, and shared retention shorter than promptCacheTTL return 400. These checks run on agent and version writes and again at session start; a model catalog that cannot be read to verify settings 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

template

object

Reviewed template id and revision used to prefill this definition.

Show child attributes

webSearchEnabled

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.

agentId

string

required

read-only

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

createdAt

string<date-time>

required

read-only

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

defaultCredentialRefs

object[]

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

defaultVaultIds

string[]

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.

disabledIntegrationMcpProviders

string[]

required

Native integration providers whose MCP tools new sessions of this agent do not receive, even though the grant is present. Suppresses integration-derived servers only, never the agent's own mcpServers. github is ignored, because a GitHub grant always keeps its MCP tools alongside git and gh in the sandbox.

mcpServers

object[]

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

Public model id from GET /managed-agents/v1/models, for example anthropic/claude-sonnet-5-5. Agent reads return the same public id. An id the catalog does not list is rejected here, before the session starts.

modelConfig

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.

organizationId

string

required

read-only

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

skills

object[]

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 a new immutable agent version

Authorizations

Headers

Path Parameters

Body

Response