Open the session analyst for a session

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "reset": false
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst"

payload = {
    "question": "<string>",
    "reset": False
}
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({question: '<string>', reset: false})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst', 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/{sessionId}/analyst",
  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([
    'question' => '<string>',
    'reset' => false
  ]),
  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/sessions/{sessionId}/analyst"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"reset\": false\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/sessions/{sessionId}/analyst")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"reset\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"question\": \"<string>\",\n  \"reset\": false\n}"

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

{
  "created": true,
  "session": {
    "computerUse": true,
    "config": {},
    "createdAt": "2023-11-07T05:31:56Z",
    "credentialRefs": [
      {
        "credentialId": "<string>",
        "vaultId": "<string>"
      }
    ],
    "credentialRefsConfigured": true,
    "kind": "api_call",
    "organizationId": "<string>",
    "rootSessionId": "<string>",
    "sessionId": "<string>",
    "sessionPath": "<string>",
    "status": "active",
    "updatedAt": "2023-11-07T05:31:56Z",
    "accessPolicy": "platform_internal",
    "activeHandoff": {
      "deadlineAt": "2023-11-07T05:31:56Z",
      "handoffId": "<string>",
      "reason": "<string>",
      "requestedAt": "2023-11-07T05:31:56Z",
      "state": "awaiting_user",
      "accessExpiresAt": "2023-11-07T05:31:56Z",
      "wakeCause": "<string>"
    },
    "agentId": "<string>",
    "agentSnapshot": {},
    "agentVersionId": "<string>",
    "budget": {
      "continuesOnRaise": true,
      "maxCostUsd": "10.00",
      "agentCapUsd": "25.00",
      "spentUsd": "4.20"
    },
    "concurrencySlotHeld": true,
    "costState": "final",
    "costUsd": "1.234567",
    "effectiveModel": "<string>",
    "environmentId": "<string>",
    "executionState": "provisioning",
    "externalSourceId": "<string>",
    "externalSourceType": "<string>",
    "failure": {
      "at": "2023-11-07T05:31:56Z",
      "category": "transient",
      "code": "<string>",
      "message": "<string>",
      "phase": "<string>",
      "retryable": true
    },
    "forkedAtEventId": "<string>",
    "lastActivityAt": "2023-11-07T05:31:56Z",
    "metadata": {},
    "modelRefId": "<string>",
    "modelSnapshot": {},
    "parentSessionId": "<string>",
    "projectId": "<string>",
    "sandboxInstanceId": "<string>",
    "sandboxProvider": "<string>",
    "sourceRefs": {},
    "stopReason": "<string>",
    "userId": "<string>",
    "vaultIds": [
      "<string>"
    ],
    "wakeAt": "2023-11-07T05:31:56Z"
  }
}

{
  "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": "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

Open the session analyst for a session

Returns the caller's session analyst for the tree containing this session, starting one if they have none (200 in both cases; created distinguishes a new conversation): a read-only assistant session that answers questions about the target -- what the agents were asked to do, what they did, which tools failed, how they coordinated, what it cost and how it was graded. Ask it questions by sending messages to the returned analyst session (managedAgentsSendSessionEventsV2) and read its answers from that session's events or event stream. One analyst per caller per tree: opening again returns the same conversation, and a body of {"reset": true} ends it; the next question starts a new one. The analyst runs on a fixed platform model with no sandbox and no credentials, and nothing it does changes the target session. Any session id in the tree is accepted; the analyst always reads the whole tree. When the tenant is out of credit, a question returns 403 session_start_not_admitted with details.reason out_of_credit and is not delivered; add credits and ask again. A suspended tenant gets the same 403 with details.reason tenant_suspended.

POST

managed-agents

sessions

{sessionId}

analyst

Open the session analyst for a session

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "reset": false
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst"

payload = {
    "question": "<string>",
    "reset": False
}
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({question: '<string>', reset: false})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/sessions/{sessionId}/analyst', 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/{sessionId}/analyst",
  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([
    'question' => '<string>',
    'reset' => false
  ]),
  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/sessions/{sessionId}/analyst"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"reset\": false\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/sessions/{sessionId}/analyst")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"reset\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"question\": \"<string>\",\n  \"reset\": false\n}"

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

{
  "created": true,
  "session": {
    "computerUse": true,
    "config": {},
    "createdAt": "2023-11-07T05:31:56Z",
    "credentialRefs": [
      {
        "credentialId": "<string>",
        "vaultId": "<string>"
      }
    ],
    "credentialRefsConfigured": true,
    "kind": "api_call",
    "organizationId": "<string>",
    "rootSessionId": "<string>",
    "sessionId": "<string>",
    "sessionPath": "<string>",
    "status": "active",
    "updatedAt": "2023-11-07T05:31:56Z",
    "accessPolicy": "platform_internal",
    "activeHandoff": {
      "deadlineAt": "2023-11-07T05:31:56Z",
      "handoffId": "<string>",
      "reason": "<string>",
      "requestedAt": "2023-11-07T05:31:56Z",
      "state": "awaiting_user",
      "accessExpiresAt": "2023-11-07T05:31:56Z",
      "wakeCause": "<string>"
    },
    "agentId": "<string>",
    "agentSnapshot": {},
    "agentVersionId": "<string>",
    "budget": {
      "continuesOnRaise": true,
      "maxCostUsd": "10.00",
      "agentCapUsd": "25.00",
      "spentUsd": "4.20"
    },
    "concurrencySlotHeld": true,
    "costState": "final",
    "costUsd": "1.234567",
    "effectiveModel": "<string>",
    "environmentId": "<string>",
    "executionState": "provisioning",
    "externalSourceId": "<string>",
    "externalSourceType": "<string>",
    "failure": {
      "at": "2023-11-07T05:31:56Z",
      "category": "transient",
      "code": "<string>",
      "message": "<string>",
      "phase": "<string>",
      "retryable": true
    },
    "forkedAtEventId": "<string>",
    "lastActivityAt": "2023-11-07T05:31:56Z",
    "metadata": {},
    "modelRefId": "<string>",
    "modelSnapshot": {},
    "parentSessionId": "<string>",
    "projectId": "<string>",
    "sandboxInstanceId": "<string>",
    "sandboxProvider": "<string>",
    "sourceRefs": {},
    "stopReason": "<string>",
    "userId": "<string>",
    "vaultIds": [
      "<string>"
    ],
    "wakeAt": "2023-11-07T05:31:56Z"
  }
}

{
  "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": "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

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

sessionId

string<uuid>

required

Session id (UUID) as returned by managedAgentsStartSession or managedAgentsListSessions.

Body

application/json

Optional request body of managedAgentsOpenSessionAnalyst. An empty body returns the caller's conversation with the tree, if any; question asks (starting the conversation if needed); reset ends the current conversation.

question

string

A question for the analyst. Starts the caller's conversation with this tree when there is none, as its first turn; otherwise it is delivered to the existing conversation. An analyst is never started without one.

reset

boolean

default:false

When true, ends the caller's current conversation with this tree: the analyst session is cancelled and stays readable, and the caller has no conversation until the next question.

Response

created

boolean

required

True when this request started the conversation.

session

object

The caller's analyst conversation for this session tree, when one exists.

Show child attributes

API reference

Endpoints

Open the session analyst for a session

Authorizations

Headers

Path Parameters

Body

Response