Skip to main content
POST
Create a fleet

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

Choose one library entry. Use platform_library_id for the shared library or tenant_library_id for the workspace library.

platform_library_id
string
required

Slug id of a platform catalog library entry to install.

tenant_library_id
string<uuid>

UUIDv7 of one of this workspace's tenant library entries to install.

name
string

Optional operator-supplied fleet name (slug-safe, lowercase/digits/hyphen, max 64 chars). Overrides the SKILL.md-derived name so one library entry can back multiple fleets in a workspace, each with its own name + webhooks. Absent ⇒ the SKILL.md name:.

Maximum string length: 64

Response

Created

fleet_id
string<uuid>
required
name
string
required

Fleet name parsed from TRIGGER.md frontmatter or the generated default trigger — the canonical identifier the user will see in agentsfleet status and CLI output.

status
string
required
Allowed value: "installing"
webhook_urls
object

Map of each webhook trigger's source → its delivery URL ({api_url}/v1/webhooks/{fleet_id}/{source}). Empty object when the fleet declares no webhook triggers.