Preview what a skill set costs the prompt

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skills": [
    {}
  ],
  "context_window_tokens": 0
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview"

payload = {
    "skills": [{}],
    "context_window_tokens": 0
}
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({skills: [{}], context_window_tokens: 0})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview', 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/skills/disclosure-preview",
  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([
    'skills' => [
        [
                
        ]
    ],
    'context_window_tokens' => 0
  ]),
  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/skills/disclosure-preview"

	payload := strings.NewReader("{\n  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\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/skills/disclosure-preview")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview")

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  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\n}"

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

{
  "budget_chars": 0,
  "entries": [
    {
      "description_included": true,
      "name": "<string>",
      "attachmentIndex": 4503599627370495,
      "skillId": "<string>"
    }
  ],
  "used_chars": 0,
  "warnings": [
    "<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": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "managed_agents_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Skills

Preview what a skill set costs the prompt

Reports how a proposed skills list would appear in an agent’s prompt, without saving anything. The list is resolved the way a session start resolves it: group attachments expand to their skills, catalog references are read, and skills that share a name collapse to one. The response lists the resulting skills in prompt order, says which of them the budget leaves room to describe, and how many characters of that budget they use. The budget is sized from context_window_tokens, and is the smallest one this service uses when that is omitted; the saved-agent skill disclosure read reports the budget a saved agent’s sessions get. A skill listed without its description can still be activated but is unlikely to be chosen, because the description is all there is to choose it by. An entry that came from an attachment carries attachmentIndex, and skillId when that attachment is a catalog skill, so it can be matched to the attachment and the catalog skill it came from. Read-only: nothing is stored.

POST

managed-agents

skills

disclosure-preview

Preview what a skill set costs the prompt

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skills": [
    {}
  ],
  "context_window_tokens": 0
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview"

payload = {
    "skills": [{}],
    "context_window_tokens": 0
}
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({skills: [{}], context_window_tokens: 0})
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview', 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/skills/disclosure-preview",
  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([
    'skills' => [
        [
                
        ]
    ],
    'context_window_tokens' => 0
  ]),
  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/skills/disclosure-preview"

	payload := strings.NewReader("{\n  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\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/skills/disclosure-preview")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview")

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  \"skills\": [\n    {}\n  ],\n  \"context_window_tokens\": 0\n}"

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

{
  "budget_chars": 0,
  "entries": [
    {
      "description_included": true,
      "name": "<string>",
      "attachmentIndex": 4503599627370495,
      "skillId": "<string>"
    }
  ],
  "used_chars": 0,
  "warnings": [
    "<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": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "managed_agents_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id

string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1

x-organization-id

string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Body

application/json

Request body for previewing tier-1 skill disclosure. Read-only: nothing is stored, and the attachments do not have to belong to any agent yet.

skills

object[] | null

required

The attachment list exactly as it would be saved on the agent, including group entries, which are expanded here the same way a session start expands them. Capped at the 100 skills a session can carry.

Maximum array length: 100

Show child attributes

context_window_tokens

integer

The context window of the model the agent will run on. Omit to be answered against the conservative floor this service uses when a window is unknown.

Required range: -9007199254740991 <= x <= 9007199254740991

Response

What a set of skill attachments costs the model's prompt on every turn, and which skills the budget has reduced to a bare name. A skill listed without its description is still activatable but is unlikely to be chosen, because the description is the only signal the model has for choosing it.

budget_chars

integer

required

Characters of prompt the model's budget allows the skill list each turn.

Required range: -9007199254740991 <= x <= 9007199254740991

entries

object[]

required

Every skill the prompt lists, in the order the model reads them.

Show child attributes

used_chars

integer

required

Characters the rendered catalog actually occupies. Measured from the same pass that produces the prompt, not estimated.

Required range: -9007199254740991 <= x <= 9007199254740991

warnings

string[]

required

What resolving and rendering this set cost: unresolvable references, truncated descriptions, and skills reduced to a name.

API reference

Endpoints

Preview what a skill set costs the prompt

Authorizations

Headers

Body

Response