Onboard a tenant Fleet library entry

curl --request POST \
  --url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "replace": false,
  "source_ref": "<string>",
  "ref": "<string>",
  "skill_markdown": "<string>",
  "trigger_markdown": "<string>"
}
'

import requests

url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries"

payload = {
    "replace": False,
    "source_ref": "<string>",
    "ref": "<string>",
    "skill_markdown": "<string>",
    "trigger_markdown": "<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({
    replace: false,
    source_ref: '<string>',
    ref: '<string>',
    skill_markdown: '<string>',
    trigger_markdown: '<string>'
  })
};

fetch('https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries', 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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries",
  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([
    'replace' => false,
    'source_ref' => '<string>',
    'ref' => '<string>',
    'skill_markdown' => '<string>',
    'trigger_markdown' => '<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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries"

	payload := strings.NewReader("{\n  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries")

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  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "content_hash": "<string>",
  "requirements": {
    "credentials": [
      "<string>"
    ],
    "tools": [
      "<string>"
    ],
    "network_hosts": [
      "<string>"
    ],
    "trigger_present": true
  }
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

POST

workspaces

{workspace_id}

fleet-libraries

Onboard a tenant Fleet library entry

curl --request POST \
  --url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "replace": false,
  "source_ref": "<string>",
  "ref": "<string>",
  "skill_markdown": "<string>",
  "trigger_markdown": "<string>"
}
'

import requests

url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries"

payload = {
    "replace": False,
    "source_ref": "<string>",
    "ref": "<string>",
    "skill_markdown": "<string>",
    "trigger_markdown": "<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({
    replace: false,
    source_ref: '<string>',
    ref: '<string>',
    skill_markdown: '<string>',
    trigger_markdown: '<string>'
  })
};

fetch('https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries', 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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries",
  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([
    'replace' => false,
    'source_ref' => '<string>',
    'ref' => '<string>',
    'skill_markdown' => '<string>',
    'trigger_markdown' => '<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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries"

	payload := strings.NewReader("{\n  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<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.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/fleet-libraries")

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  \"replace\": false,\n  \"source_ref\": \"<string>\",\n  \"ref\": \"<string>\",\n  \"skill_markdown\": \"<string>\",\n  \"trigger_markdown\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "content_hash": "<string>",
  "requirements": {
    "credentials": [
      "<string>"
    ],
    "tools": [
      "<string>"
    ],
    "network_hosts": [
      "<string>"
    ],
    "trigger_present": true
  }
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

{
  "docs_uri": "https://docs.agentsfleet.net/api-reference/error-codes#UZ-AGT-009",
  "title": "Fleet not found",
  "detail": "No fleet with id 'abc123' in this workspace.",
  "error_code": "UZ-AGT-009",
  "request_id": "<string>",
  "current_state": "paused",
  "user_message": "We couldn't find that Fleet. It may have been deleted, or the ID doesn't match one in this workspace.",
  "etag": "<string>"
}

Authorizations

Authorization

string

header

required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id

string<uuid>

required

UUIDv7 of the workspace.

Body

application/json

source_kind

enum<string>

required

Where the entry comes from. github and template are fetched and validated server-side; upload carries the SKILL.md (and optional TRIGGER.md) Markdown inline for a skill-only entry.

Available options:

template,

upload,

github

replace

boolean

default:false

Platform tier only. The catalog id comes from the bundle's SKILL.md frontmatter name, not this repository path. So a bundle may declare a name another repository already owns. That is refused with UZ-CATALOG-004, rather than silently swapping the bundle every workspace installs. Retry with replace: true to overwrite it deliberately.

source_ref

string

Required for github (an owner/repo locator) and template (a first-party template id).

Maximum string length: 512

ref

string

Optional branch or tag for github sources; absent fetches the default branch. The dashboard's Fetch-update sends the entry's stored ref, so a ref pinned via the catalog PATCH is honored by the refetch rather than silently reset. Same character rules as a repository segment.

Maximum string length: 100

skill_markdown

string

Raw SKILL.md bytes. Required for upload; ignored for fetched sources.

Maximum string length: 204800

trigger_markdown

string

Optional raw TRIGGER.md bytes for upload. Ignored for fetched sources.

Maximum string length: 204800

Response

Entry onboarded into the workspace catalog.

Result of onboarding a Fleet library entry (platform or tenant tier). Carries the entry identity, its tier in visibility, the content hash, and the derived requirements — never a support-file manifest, an object-store key, or support-file content.

string

required

Entry id — the slug for platform entries, a UUIDv7 for tenant entries.

name

string

required

visibility

enum<string>

required

The catalog tier the entry was onboarded into.

Available options:

platform,

tenant

content_hash

string

required

SHA-256 content hash of the onboarded snapshot.

requirements

object

required

Show child attributes

Onboard a platform Fleet library entry Curate, publish, or unpublish a platform Fleet library entry

Overview

Health

Authentication

API keys

Tenants

Tenant provider

Tenant balance

Tenant models

Fleet

Model Library

Workspaces

Workspace preferences

Fleet keys

Secrets

Connectors

Approvals

Fleets

Fleet library

Fleet messages

Fleet memories

Fleet schedules

Fleet events

Integration grants

Webhooks

Admin

Onboard a tenant Fleet library entry

Authorizations

Path Parameters

Body

Response