Interrupt a session and send a replacement instruction
curl --request POST \
--url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": [
{
"byte_size": 0,
"content": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"message": "<string>",
"referenced_session_ids": [
"<string>"
]
}
'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send"
payload = {
"content": [
{
"byte_size": 0,
"content": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"message": "<string>",
"referenced_session_ids": ["<string>"]
}
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({
content: [
{
byte_size: 0,
content: [
{
byte_size: 0,
content: '<array>',
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: '<array>',
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: [
{
byte_size: 0,
content: '<array>',
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: '<array>',
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
message: '<string>',
referenced_session_ids: ['<string>']
})
};
fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send', 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/sessions/{sessionId}/interrupt-and-send",
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([
'content' => [
[
'byte_size' => 0,
'content' => [
[
'byte_size' => 0,
'content' => '<array>',
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => '<array>',
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => [
[
'byte_size' => 0,
'content' => '<array>',
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => '<array>',
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'message' => '<string>',
'referenced_session_ids' => [
'<string>'
]
]),
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/sessions/{sessionId}/interrupt-and-send"
payload := strings.NewReader("{\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\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/sessions/{sessionId}/interrupt-and-send")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send")
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 \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"delivery_state": "stored",
"events_accepted": 0,
"ok": 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": "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_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
}
}Sessions
Interrupt a session and send a replacement instruction
Stops active work and durably accepts a replacement instruction in one ordered operation. The session starts a fresh turn automatically. A session started before replacement instructions were available still honors the interrupt and keeps the replacement for its next resume. When the tenant is out of credit it returns 403 session_start_not_admitted with details.reason out_of_credit and changes nothing, and a suspended tenant gets the same 403 with details.reason tenant_suspended; managedAgentsInterruptSession still stops the session.
POST
/
managed-agents
/
v1
/
sessions
/
{sessionId}
/
interrupt-and-send
Interrupt a session and send a replacement instruction
curl --request POST \
--url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": [
{
"byte_size": 0,
"content": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": true,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": true,
"provider": "<string>",
"provider_payload": true,
"redacted": true,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"message": "<string>",
"referenced_session_ids": [
"<string>"
]
}
'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send"
payload = {
"content": [
{
"byte_size": 0,
"content": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": [
{
"byte_size": 0,
"content": "<array>",
"context": "<string>",
"data": "<string>",
"encrypted_content": "<string>",
"height": 0,
"id": "<string>",
"input": {},
"is_error": True,
"media_type": "<string>",
"name": "<string>",
"omitted_bytes": 0,
"payload": True,
"provider": "<string>",
"provider_payload": True,
"redacted": True,
"semantic_hint": "<string>",
"sha256": "<string>",
"signature": "<string>",
"summary": "<array>",
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"text": "<string>",
"title": "<string>",
"tool_use_id": "<string>",
"type": "<string>",
"uri": "<string>",
"width": 0
}
],
"message": "<string>",
"referenced_session_ids": ["<string>"]
}
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({
content: [
{
byte_size: 0,
content: [
{
byte_size: 0,
content: '<array>',
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: '<array>',
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: [
{
byte_size: 0,
content: '<array>',
context: '<string>',
data: '<string>',
encrypted_content: '<string>',
height: 0,
id: '<string>',
input: {},
is_error: true,
media_type: '<string>',
name: '<string>',
omitted_bytes: 0,
payload: true,
provider: '<string>',
provider_payload: true,
redacted: true,
semantic_hint: '<string>',
sha256: '<string>',
signature: '<string>',
summary: '<array>',
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
text: '<string>',
title: '<string>',
tool_use_id: '<string>',
type: '<string>',
uri: '<string>',
width: 0
}
],
message: '<string>',
referenced_session_ids: ['<string>']
})
};
fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send', 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/sessions/{sessionId}/interrupt-and-send",
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([
'content' => [
[
'byte_size' => 0,
'content' => [
[
'byte_size' => 0,
'content' => '<array>',
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => '<array>',
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => [
[
'byte_size' => 0,
'content' => '<array>',
'context' => '<string>',
'data' => '<string>',
'encrypted_content' => '<string>',
'height' => 0,
'id' => '<string>',
'input' => [
],
'is_error' => true,
'media_type' => '<string>',
'name' => '<string>',
'omitted_bytes' => 0,
'payload' => true,
'provider' => '<string>',
'provider_payload' => true,
'redacted' => true,
'semantic_hint' => '<string>',
'sha256' => '<string>',
'signature' => '<string>',
'summary' => '<array>',
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'text' => '<string>',
'title' => '<string>',
'tool_use_id' => '<string>',
'type' => '<string>',
'uri' => '<string>',
'width' => 0
]
],
'message' => '<string>',
'referenced_session_ids' => [
'<string>'
]
]),
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/sessions/{sessionId}/interrupt-and-send"
payload := strings.NewReader("{\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\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/sessions/{sessionId}/interrupt-and-send")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{sessionId}/interrupt-and-send")
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 \"content\": [\n {\n \"byte_size\": 0,\n \"content\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": [\n {\n \"byte_size\": 0,\n \"content\": \"<array>\",\n \"context\": \"<string>\",\n \"data\": \"<string>\",\n \"encrypted_content\": \"<string>\",\n \"height\": 0,\n \"id\": \"<string>\",\n \"input\": {},\n \"is_error\": true,\n \"media_type\": \"<string>\",\n \"name\": \"<string>\",\n \"omitted_bytes\": 0,\n \"payload\": true,\n \"provider\": \"<string>\",\n \"provider_payload\": true,\n \"redacted\": true,\n \"semantic_hint\": \"<string>\",\n \"sha256\": \"<string>\",\n \"signature\": \"<string>\",\n \"summary\": \"<array>\",\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"text\": \"<string>\",\n \"title\": \"<string>\",\n \"tool_use_id\": \"<string>\",\n \"type\": \"<string>\",\n \"uri\": \"<string>\",\n \"width\": 0\n }\n ],\n \"message\": \"<string>\",\n \"referenced_session_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"delivery_state": "stored",
"events_accepted": 0,
"ok": 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": "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_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
A Recursion API key, created in the console under API keys.
Headers
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:
1Organization 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:
1Path Parameters
Session id (UUID) as returned by managedAgentsStartSession or managedAgentsListSessions.
Body
application/json
Request body for interrupting the active operation and starting a fresh turn with one replacement instruction.
Replacement instruction blocks in this API's format. A top-level image or document block may name a file from the organization's catalog with source {type: file, file_id}, resolved exactly as on managedAgentsSendSessionEvents; a refusal names the block as content[j]. Blocks are rebuilt for each model provider, and block types a provider request does not support never reach the model. Takes precedence over message.
Show child attributes
Show child attributes
Replacement instruction for the fresh turn. Ignored when content is present; otherwise required, and refused with 400 when empty or only whitespace.
Prior sessions this session may read from the fresh turn on, by session id, added to any it already has. Authorized and recorded before the interrupt is signaled, so redirecting the agent at an earlier run is one request rather than two.
Maximum array length:
10Response
Shared response body of POST /managed-agents/v1/sessions/{sessionId}/events and POST /managed-agents/v1/sessions/{sessionId}/interrupt-and-send. It acknowledges durable acceptance of the turn, never the agent's reply: read the reply by listing events or streaming. Compare events_accepted against what was sent to detect silently dropped entries, and read delivery_state to learn whether an agent is actually going to act on them. events_accepted counts canonical events rather than requests, so interrupt-and-send reports 2 for its single instruction: the stop and the message that follows it.
Shared response body of POST /managed-agents/v1/sessions/{sessionId}/events and POST /managed-agents/v1/sessions/{sessionId}/interrupt-and-send. It acknowledges durable acceptance of the turn, never the agent's reply: read the reply by listing events or streaming. Compare events_accepted against what was sent to detect silently dropped entries, and read delivery_state to learn whether an agent is actually going to act on them. events_accepted counts canonical events rather than requests, so interrupt-and-send reports 2 for its single instruction: the stop and the message that follows it.
How the accepted events reached a reader. queued: the agent was mid-turn, so the input is waiting outside the transcript and the next turn boundary will read it; interrupt to bring that forward. signaled: the running session was woken and will act on them. resumed: the session had already finished, so it resumed to act on them. stored: appended to the timeline with nothing running to act on them yet.
Available options:
stored, signaled, resumed, queued How many canonical events were written or queued. This counts the inputs actually derived from the body, not its length: a plain message body yields 1, and a typed user.message with no content is dropped, so this can be lower than the events array sent.
Required range:
-9007199254740991 <= x <= 9007199254740991Always true. Every event in the request was durably accepted; any partial or total failure is an HTTP error instead, so this field never reports false.