Curate, publish, or unpublish a platform Fleet library entry

curl --request PATCH \
  --url https://api.agentsfleet.net/v1/admin/fleet-libraries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "source_repo": "<string>",
  "source_ref": "<string>",
  "description": "<string>",
  "required_credentials_reasons": {},
  "published": true
}
'

import requests

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

payload = {
    "name": "<string>",
    "source_repo": "<string>",
    "source_ref": "<string>",
    "description": "<string>",
    "required_credentials_reasons": {},
    "published": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    source_repo: '<string>',
    source_ref: '<string>',
    description: '<string>',
    required_credentials_reasons: {},
    published: true
  })
};

fetch('https://api.agentsfleet.net/v1/admin/fleet-libraries/{id}', 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/admin/fleet-libraries/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'source_repo' => '<string>',
    'source_ref' => '<string>',
    'description' => '<string>',
    'required_credentials_reasons' => [
        
    ],
    'published' => true
  ]),
  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/admin/fleet-libraries/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.agentsfleet.net/v1/admin/fleet-libraries/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "source_repo": "<string>",
  "source_ref": "<string>",
  "content_hash": "<string>",
  "requirements": {
    "credentials": [
      "<string>"
    ],
    "tools": [
      "<string>"
    ],
    "network_hosts": [
      "<string>"
    ],
    "trigger_present": true
  },
  "required_credentials_reasons": {},
  "etag": "<string>",
  "updated_at": 123
}

{
  "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>"
}

{
  "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>"
}

Fleet library

Curate, publish, or unpublish a platform Fleet library entry

Partial update. description and required_credentials_reasons are the two fields no bundle can supply, so they are operator-owned: a later bundle refetch never overwrites them. published moves the entry between draft (stored, invisible to every tenant) and public (live in every workspace gallery and installable). Publishing an entry whose bundle was never fetched is refused — a published entry always has something to install. Requires the platform-library:write scope. Send If-Match with the row’s etag to reject stale edits before they can repoint the source or unpublish the entry. Omitting the header preserves last-write-wins behavior.

PATCH

admin

fleet-libraries

{id}

Curate, publish, or unpublish a platform Fleet library entry

curl --request PATCH \
  --url https://api.agentsfleet.net/v1/admin/fleet-libraries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "source_repo": "<string>",
  "source_ref": "<string>",
  "description": "<string>",
  "required_credentials_reasons": {},
  "published": true
}
'

import requests

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

payload = {
    "name": "<string>",
    "source_repo": "<string>",
    "source_ref": "<string>",
    "description": "<string>",
    "required_credentials_reasons": {},
    "published": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    source_repo: '<string>',
    source_ref: '<string>',
    description: '<string>',
    required_credentials_reasons: {},
    published: true
  })
};

fetch('https://api.agentsfleet.net/v1/admin/fleet-libraries/{id}', 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/admin/fleet-libraries/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'source_repo' => '<string>',
    'source_ref' => '<string>',
    'description' => '<string>',
    'required_credentials_reasons' => [
        
    ],
    'published' => true
  ]),
  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/admin/fleet-libraries/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.agentsfleet.net/v1/admin/fleet-libraries/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"source_repo\": \"<string>\",\n  \"source_ref\": \"<string>\",\n  \"description\": \"<string>\",\n  \"required_credentials_reasons\": {},\n  \"published\": true\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "source_repo": "<string>",
  "source_ref": "<string>",
  "content_hash": "<string>",
  "requirements": {
    "credentials": [
      "<string>"
    ],
    "tools": [
      "<string>"
    ],
    "network_hosts": [
      "<string>"
    ],
    "trigger_present": true
  },
  "required_credentials_reasons": {},
  "etag": "<string>",
  "updated_at": 123
}

{
  "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>"
}

{
  "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

Headers

If-Match

string

Optional catalog row version from the list response. Stale values return 412 with the current etag.

Path Parameters

string

required

The catalog id — the bundle's SKILL.md frontmatter name (a slug, not a UUID).

Body

application/json

Partial update of a catalog entry. Every field is optional, and an absent field is left untouched. Editing the description never blanks the credential copy, and the entry id is never patchable.

A source_repo or source_ref that differs from the stored value discards the stored bundle and returns the entry to draft, atomically. The bundle was built from the old source, so an entry never advertises a source it is not serving. Re-sending the stored value is a no-op.

name

string

Display name. Operator-owned — survives bundle refetches.

Maximum string length: 200

source_repo

string

owner/repo. Validated with the same rules as onboarding.

Maximum string length: 512

source_ref

string

Branch or tag the next fetch should use.

Maximum string length: 100

description

string

required_credentials_reasons

object

Show child attributes

published

boolean

true publishes the entry (requires a bundle); false withdraws it back to draft, which removes it from every gallery and blocks new installs. Workspaces already running the fleet are unaffected.

Response

The entry as it now stands.

One row of the platform Fleet library catalog, as the operator sees it. Metadata only — never bundle markdown, a support-file body, or an object-store key.

string

required

The catalog id — the bundle's SKILL.md frontmatter name.

name

string

required

description

string

required

Operator-owned after the entry is created. Seeded from the bundle on the first fetch; a later refetch never overwrites it.

source_repo

string

required

The GitHub repository the bundle was fetched from, as owner/repo.

source_ref

string

required

The git ref the bundle was fetched at.

visibility

enum<string>

required

The publish lifecycle. draft — the bundle is stored and the fleet is invisible to every tenant. public — live in every workspace gallery and installable.

Available options:

draft,

public

content_hash

string | null

required

The content hash of the stored bundle, or null when no bundle has ever been fetched for this entry. A null hash can never be published.

requirements

object

required

Show child attributes

required_credentials_reasons

object

required

Per-credential "why this fleet needs it" copy, keyed by credential name, shown at the install gate. Operator-owned: the importer cannot derive it, and a bundle refetch never overwrites it.

Show child attributes

etag

string

required

Optimistic-concurrency tag over the operator-editable catalog row fields. Send it as If-Match on PATCH to prevent stale overwrites.

updated_at

integer<int64>

required

Milliseconds since the Unix epoch.

Onboard a tenant Fleet library entry Delete an unpublished 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

Curate, publish, or unpublish a platform Fleet library entry

Authorizations

Headers

Path Parameters

Body

Response