Get the team board

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board', 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/{session_id}/board",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "as_of": "2023-11-07T05:31:56Z",
  "posts": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "kind": "notice",
      "post_id": "<string>",
      "text": "<string>",
      "task_ids": [
        "<string>"
      ]
    }
  ],
  "tasks": [
    {
      "body": "<string>",
      "claim_generation": 0,
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "kind": "task",
      "seq": 0,
      "status": "open",
      "task_id": "<string>",
      "title": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "artifacts": [
        "<string>"
      ],
      "blocked_on": [
        "<string>"
      ],
      "notes": [
        {
          "at": "2023-11-07T05:31:56Z",
          "by": "<string>",
          "text": "<string>"
        }
      ],
      "outcome": {
        "summary": "<string>",
        "artifacts": [
          "<string>"
        ],
        "confidence": "<string>"
      },
      "owner_session_id": "<string>"
    }
  ],
  "members": [
    {
      "name": "<string>",
      "session_id": "<string>",
      "leader": true,
      "state": "<string>"
    }
  ]
}

{
  "code": "invalid_request",
  "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": "payload_too_large",
  "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
  }
}

Sessions

Get the team board

Returns the shared task board of a session whose roster runs as a team: every task with its status, owner, notes, and outcome; the notices and the decision; and the members named the way the board names them. Any session id in the tree is accepted; the read resolves to its root. A session whose tree is not a team is a 404. Each transition is also recorded as a board_update event on the root’s log, but that log interleaves events written by every member, so a reader paging it by event id after a cursor can skip one; this read is the authoritative state, and a poller should refresh from it rather than reconstruct the board from events alone.

GET

managed-agents

sessions

{session_id}

board

Get the team board

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board', 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/{session_id}/board",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/board")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "as_of": "2023-11-07T05:31:56Z",
  "posts": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "kind": "notice",
      "post_id": "<string>",
      "text": "<string>",
      "task_ids": [
        "<string>"
      ]
    }
  ],
  "tasks": [
    {
      "body": "<string>",
      "claim_generation": 0,
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "kind": "task",
      "seq": 0,
      "status": "open",
      "task_id": "<string>",
      "title": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "artifacts": [
        "<string>"
      ],
      "blocked_on": [
        "<string>"
      ],
      "notes": [
        {
          "at": "2023-11-07T05:31:56Z",
          "by": "<string>",
          "text": "<string>"
        }
      ],
      "outcome": {
        "summary": "<string>",
        "artifacts": [
          "<string>"
        ],
        "confidence": "<string>"
      },
      "owner_session_id": "<string>"
    }
  ],
  "members": [
    {
      "name": "<string>",
      "session_id": "<string>",
      "leader": true,
      "state": "<string>"
    }
  ]
}

{
  "code": "invalid_request",
  "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": "payload_too_large",
  "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

session_id

string<uuid>

required

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

Response

A snapshot of one session tree's shared task board: its tasks, posts, and members. Present once the tree has entered team state; an auto-mode tree that has not posted reads as an empty board.

as_of

string<date-time>

required

RFC 3339 server time at which the snapshot was read, so a reader can age claims.

posts

object[]

required

Every notice, recommendation, and decision in posting order.

Show child attributes

tasks

object[]

required

Every task on the board in posting order, including done and dropped ones.

Show child attributes

members

object[]

The sessions that may act on the board. Omitted when the reader did not resolve members.

Show child attributes

API reference

Endpoints

Get the team board

Authorizations

Headers

Path Parameters

Response