Create a skill from a document

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document": "<string>",
  "displayTitle": "<string>",
  "manifest": [
    "<string>"
  ],
  "metadata": {},
  "skillGroupId": "<string>"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/skills"

payload = {
    "document": "<string>",
    "displayTitle": "<string>",
    "manifest": ["<string>"],
    "metadata": {},
    "skillGroupId": "<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({
    document: '<string>',
    displayTitle: '<string>',
    manifest: ['<string>'],
    metadata: {},
    skillGroupId: '<string>'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/skills', 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/skills",
  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([
    'document' => '<string>',
    'displayTitle' => '<string>',
    'manifest' => [
        '<string>'
    ],
    'metadata' => [
        
    ],
    'skillGroupId' => '<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/v2/skills"

	payload := strings.NewReader("{\n  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\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/skills")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\n}"

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

{
  "createdAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "name": "<string>",
  "organizationId": "<string>",
  "skillId": "<string>",
  "source": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "displayTitle": "<string>",
  "latestInstructionChars": 0,
  "latestSkillVersionId": "<string>",
  "latestVersionNumber": 0,
  "metadata": {},
  "skillGroupId": "<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": "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": "idempotency_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

Create a skill from a document

Creates a skill from a SKILL.md document and returns it. The document’s frontmatter supplies the skill’s name and description, which are validated against the Agent Skills standard: the name must be lowercase letters, digits, and single hyphens, and a description is required because it is the only signal the model has when deciding whether to use the skill. To create one from a zipped directory instead, use managedAgentsPublishSkillBundleV2. Do not automatically retry an ambiguous transport failure: list skills first, because this operation does not replay a prior response and another submission can create another skill.

POST

managed-agents

skills

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v2/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document": "<string>",
  "displayTitle": "<string>",
  "manifest": [
    "<string>"
  ],
  "metadata": {},
  "skillGroupId": "<string>"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v2/skills"

payload = {
    "document": "<string>",
    "displayTitle": "<string>",
    "manifest": ["<string>"],
    "metadata": {},
    "skillGroupId": "<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({
    document: '<string>',
    displayTitle: '<string>',
    manifest: ['<string>'],
    metadata: {},
    skillGroupId: '<string>'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v2/skills', 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/skills",
  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([
    'document' => '<string>',
    'displayTitle' => '<string>',
    'manifest' => [
        '<string>'
    ],
    'metadata' => [
        
    ],
    'skillGroupId' => '<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/v2/skills"

	payload := strings.NewReader("{\n  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\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/skills")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"document\": \"<string>\",\n  \"displayTitle\": \"<string>\",\n  \"manifest\": [\n    \"<string>\"\n  ],\n  \"metadata\": {},\n  \"skillGroupId\": \"<string>\"\n}"

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

{
  "createdAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "name": "<string>",
  "organizationId": "<string>",
  "skillId": "<string>",
  "source": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "displayTitle": "<string>",
  "latestInstructionChars": 0,
  "latestSkillVersionId": "<string>",
  "latestVersionNumber": 0,
  "metadata": {},
  "skillGroupId": "<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": "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": "idempotency_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

Idempotency-Key

string

Optional replay-protection key scoped to the verified tenant, principal, operation and decoded resource path. Equivalent JSON formatting and field order use the same fingerprint. Matching retries replay the original 201 result and Location; conflicting reuse returns 409 idempotency_conflict and an active request returns 409 idempotency_in_progress. Completed receipts last approximately 24 hours and pending claims may be reclaimed after approximately 1 hour. No deduplication is guaranteed after expiry.

Required string length: 1 - 256

Pattern: ^[!-~]+$

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

document

string

required

write-only

displayTitle

string

manifest

string[]

write-only

metadata

object

Show child attributes

skillGroupId

string

Response

Created

createdAt

string<date-time>

required

read-only

description

string

required

read-only

name

string

required

read-only

organizationId

string

required

read-only

skillId

string

required

read-only

source

string

required

read-only

updatedAt

string<date-time>

required

read-only

displayTitle

string

latestInstructionChars

integer<int64>

read-only

Required range: -9007199254740991 <= x <= 9007199254740991

latestSkillVersionId

string

read-only

latestVersionNumber

integer<int64>

read-only

Required range: -9007199254740991 <= x <= 9007199254740991

metadata

object

Show child attributes

skillGroupId

string

API reference

Endpoints

Create a skill from a document

Authorizations

Headers

Body

Response