Start a managed session
curl --request POST \
--url https://api.recursion.labelbox.com/managed-agents/v2/sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"agentId": "<string>",
"credentialRefs": [
{
"credentialId": "<string>",
"vaultId": "<string>"
}
],
"environmentId": "<string>",
"externalSourceId": "<string>",
"externalSourceType": "<string>",
"message": "<string>",
"metadata": {},
"outcome": {
"criteria": [
{
"criterionKey": "<string>",
"criterionText": "<string>",
"label": "<string>",
"section": "<string>"
}
],
"description": "<string>",
"evaluatorAgentId": "<string>",
"maxIterations": 5,
"rubric": "<string>"
},
"projectId": "<string>",
"referencedSessionIds": [
"<string>"
],
"resources": [
{
"fileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "file",
"mountPath": "<string>",
"relativePath": "<string>"
}
],
"skipDefaultOutcome": false,
"team": {},
"vaultIds": [
"<string>"
]
}
'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v2/sessions"
payload = {
"agentId": "<string>",
"credentialRefs": [
{
"credentialId": "<string>",
"vaultId": "<string>"
}
],
"environmentId": "<string>",
"externalSourceId": "<string>",
"externalSourceType": "<string>",
"message": "<string>",
"metadata": {},
"outcome": {
"criteria": [
{
"criterionKey": "<string>",
"criterionText": "<string>",
"label": "<string>",
"section": "<string>"
}
],
"description": "<string>",
"evaluatorAgentId": "<string>",
"maxIterations": 5,
"rubric": "<string>"
},
"projectId": "<string>",
"referencedSessionIds": ["<string>"],
"resources": [
{
"fileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "file",
"mountPath": "<string>",
"relativePath": "<string>"
}
],
"skipDefaultOutcome": False,
"team": {},
"vaultIds": ["<string>"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
agentId: '<string>',
credentialRefs: [{credentialId: '<string>', vaultId: '<string>'}],
environmentId: '<string>',
externalSourceId: '<string>',
externalSourceType: '<string>',
message: '<string>',
metadata: {},
outcome: {
criteria: [
{
criterionKey: '<string>',
criterionText: '<string>',
label: '<string>',
section: '<string>'
}
],
description: '<string>',
evaluatorAgentId: '<string>',
maxIterations: 5,
rubric: '<string>'
},
projectId: '<string>',
referencedSessionIds: ['<string>'],
resources: [
{
fileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
type: 'file',
mountPath: '<string>',
relativePath: '<string>'
}
],
skipDefaultOutcome: false,
team: {},
vaultIds: ['<string>']
})
};
fetch('https://api.recursion.labelbox.com/managed-agents/v2/sessions', 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/sessions",
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([
'agentId' => '<string>',
'credentialRefs' => [
[
'credentialId' => '<string>',
'vaultId' => '<string>'
]
],
'environmentId' => '<string>',
'externalSourceId' => '<string>',
'externalSourceType' => '<string>',
'message' => '<string>',
'metadata' => [
],
'outcome' => [
'criteria' => [
[
'criterionKey' => '<string>',
'criterionText' => '<string>',
'label' => '<string>',
'section' => '<string>'
]
],
'description' => '<string>',
'evaluatorAgentId' => '<string>',
'maxIterations' => 5,
'rubric' => '<string>'
],
'projectId' => '<string>',
'referencedSessionIds' => [
'<string>'
],
'resources' => [
[
'fileId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'type' => 'file',
'mountPath' => '<string>',
'relativePath' => '<string>'
]
],
'skipDefaultOutcome' => false,
'team' => [
],
'vaultIds' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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/sessions"
payload := strings.NewReader("{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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/sessions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v2/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"sessionId": "<string>",
"statusUrl": "<string>"
}{
"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": "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": "environment_not_verified",
"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": "content_store_unconfigured",
"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
}
}Sessions
Start a managed session
Starts a managed agent session and returns 202 with its sessionId and statusUrl; the agent runs asynchronously, so poll managedAgentsGetSessionV2 or subscribe with managedAgentsStreamSessionEventsV2 to follow it. Omit environmentId to run without an own sandbox and use the on-demand compute tools; a selected environment keeps its own sandbox. Model calls and running compute are billed. Requires an Idempotency-Key header: the same key with the exact HTTP method, escaped path, raw query, and raw body bytes returns the original session; any difference is rejected. A reasoning_effort incompatible with the selected model or its frozen output capacity returns 400 before provisioning. Enabled provider_params.promptCacheTTL or provider_params.promptCacheSharedTTL settings with invalid values, an unsupported model, or shared retention shorter than history retention also return 400 before provisioning for the selected root agent version, including for previously stored agent versions. Roster agent cache settings are validated at delegation before creating each child session. A temporarily unavailable model reference or catalog dependency returns 503. An environment on managed compute whose setup script has no verified, current run returns 422 environment_not_verified before provisioning; run managedAgentsCreateEnvironmentSetupRunV2 first. When the tenant is out of credit it returns 403 session_start_not_admitted with details.reason out_of_credit; add credits and retry. When the tenant is suspended it returns the same 403 with details.reason tenant_suspended. A budget above the agent’s multiagent.limits.max_tree_cost_usd returns 400. When the tenant already has as many sessions working at once as it may, it returns 429 tenant_concurrency_limit with details.limit; wait for a session to finish its turn or stop one, then retry.
POST
/
managed-agents
/
v2
/
sessions
Start a managed session
curl --request POST \
--url https://api.recursion.labelbox.com/managed-agents/v2/sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"agentId": "<string>",
"credentialRefs": [
{
"credentialId": "<string>",
"vaultId": "<string>"
}
],
"environmentId": "<string>",
"externalSourceId": "<string>",
"externalSourceType": "<string>",
"message": "<string>",
"metadata": {},
"outcome": {
"criteria": [
{
"criterionKey": "<string>",
"criterionText": "<string>",
"label": "<string>",
"section": "<string>"
}
],
"description": "<string>",
"evaluatorAgentId": "<string>",
"maxIterations": 5,
"rubric": "<string>"
},
"projectId": "<string>",
"referencedSessionIds": [
"<string>"
],
"resources": [
{
"fileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "file",
"mountPath": "<string>",
"relativePath": "<string>"
}
],
"skipDefaultOutcome": false,
"team": {},
"vaultIds": [
"<string>"
]
}
'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v2/sessions"
payload = {
"agentId": "<string>",
"credentialRefs": [
{
"credentialId": "<string>",
"vaultId": "<string>"
}
],
"environmentId": "<string>",
"externalSourceId": "<string>",
"externalSourceType": "<string>",
"message": "<string>",
"metadata": {},
"outcome": {
"criteria": [
{
"criterionKey": "<string>",
"criterionText": "<string>",
"label": "<string>",
"section": "<string>"
}
],
"description": "<string>",
"evaluatorAgentId": "<string>",
"maxIterations": 5,
"rubric": "<string>"
},
"projectId": "<string>",
"referencedSessionIds": ["<string>"],
"resources": [
{
"fileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "file",
"mountPath": "<string>",
"relativePath": "<string>"
}
],
"skipDefaultOutcome": False,
"team": {},
"vaultIds": ["<string>"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
agentId: '<string>',
credentialRefs: [{credentialId: '<string>', vaultId: '<string>'}],
environmentId: '<string>',
externalSourceId: '<string>',
externalSourceType: '<string>',
message: '<string>',
metadata: {},
outcome: {
criteria: [
{
criterionKey: '<string>',
criterionText: '<string>',
label: '<string>',
section: '<string>'
}
],
description: '<string>',
evaluatorAgentId: '<string>',
maxIterations: 5,
rubric: '<string>'
},
projectId: '<string>',
referencedSessionIds: ['<string>'],
resources: [
{
fileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
type: 'file',
mountPath: '<string>',
relativePath: '<string>'
}
],
skipDefaultOutcome: false,
team: {},
vaultIds: ['<string>']
})
};
fetch('https://api.recursion.labelbox.com/managed-agents/v2/sessions', 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/sessions",
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([
'agentId' => '<string>',
'credentialRefs' => [
[
'credentialId' => '<string>',
'vaultId' => '<string>'
]
],
'environmentId' => '<string>',
'externalSourceId' => '<string>',
'externalSourceType' => '<string>',
'message' => '<string>',
'metadata' => [
],
'outcome' => [
'criteria' => [
[
'criterionKey' => '<string>',
'criterionText' => '<string>',
'label' => '<string>',
'section' => '<string>'
]
],
'description' => '<string>',
'evaluatorAgentId' => '<string>',
'maxIterations' => 5,
'rubric' => '<string>'
],
'projectId' => '<string>',
'referencedSessionIds' => [
'<string>'
],
'resources' => [
[
'fileId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'type' => 'file',
'mountPath' => '<string>',
'relativePath' => '<string>'
]
],
'skipDefaultOutcome' => false,
'team' => [
],
'vaultIds' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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/sessions"
payload := strings.NewReader("{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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/sessions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v2/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agentId\": \"<string>\",\n \"credentialRefs\": [\n {\n \"credentialId\": \"<string>\",\n \"vaultId\": \"<string>\"\n }\n ],\n \"environmentId\": \"<string>\",\n \"externalSourceId\": \"<string>\",\n \"externalSourceType\": \"<string>\",\n \"message\": \"<string>\",\n \"metadata\": {},\n \"outcome\": {\n \"criteria\": [\n {\n \"criterionKey\": \"<string>\",\n \"criterionText\": \"<string>\",\n \"label\": \"<string>\",\n \"section\": \"<string>\"\n }\n ],\n \"description\": \"<string>\",\n \"evaluatorAgentId\": \"<string>\",\n \"maxIterations\": 5,\n \"rubric\": \"<string>\"\n },\n \"projectId\": \"<string>\",\n \"referencedSessionIds\": [\n \"<string>\"\n ],\n \"resources\": [\n {\n \"fileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"type\": \"file\",\n \"mountPath\": \"<string>\",\n \"relativePath\": \"<string>\"\n }\n ],\n \"skipDefaultOutcome\": false,\n \"team\": {},\n \"vaultIds\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"sessionId": "<string>",
"statusUrl": "<string>"
}{
"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": "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": "environment_not_verified",
"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": "content_store_unconfigured",
"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
Headers
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. 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 - 256Pattern:
^[!-~]+$Body
application/json