List available models

curl --request GET \
  --url https://api.agentsfleet.net/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.agentsfleet.net/v1/models', 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/models",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agentsfleet.net/v1/models"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/models")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "version": "<string>",
  "models": [
    {
      "id": "<string>",
      "provider": "<string>",
      "context_cap_tokens": 123,
      "input_nanos_per_mtok": 123,
      "cached_input_nanos_per_mtok": 123,
      "output_nanos_per_mtok": 123
    }
  ],
  "total": 123,
  "next_cursor": "<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>"
}

Model Library

List available models

Returns models available to the tenant. Each item includes its provider, context limit, and usage fields. An empty library returns an empty array.

A bounded keyset page ordered by normalized model_id, then normalized provider, then an opaque row identity. Every comparison runs under COLLATE "C", so the order is byte-wise and stable across locales. Follow next_cursor to read the whole catalogue; a client that reads only the first page silently loses every model past it.

The response is conditionally revalidated. Every answer carries an ETag over the exact bytes served, plus Cache-Control: private, no-cache and Vary: Authorization. Send the tag back as If-None-Match and a match answers 304 with no body and the same headers. private is what stops a shared proxy handing one tenant’s response to another even though the payload is identical for every authorized caller.

GET

models

List available models

curl --request GET \
  --url https://api.agentsfleet.net/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.agentsfleet.net/v1/models', 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/models",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agentsfleet.net/v1/models"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/models")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "version": "<string>",
  "models": [
    {
      "id": "<string>",
      "provider": "<string>",
      "context_cap_tokens": 123,
      "input_nanos_per_mtok": 123,
      "cached_input_nanos_per_mtok": 123,
      "output_nanos_per_mtok": 123
    }
  ],
  "total": 123,
  "next_cursor": "<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

Query Parameters

limit

integer

default:50

Rows per page, 1..100. Defaults to 50.

Required range: 1 <= x <= 100

starting_after

string

Opaque cursor from a previous page's next_cursor. Bound to the filters and page size that produced it. A cursor this endpoint never issued is UZ-LIBRARY-001. A real cursor carrying different filters or a different page size is UZ-LIBRARY-002, rather than a silently different page. Only the sort boundary is read from it — the filters applied are always the request's.

provider

string

Exact match on the normalized provider. At most 128 bytes once normalized; empty after normalization is treated as absent.

Maximum string length: 128

Response

One page of the model library catalogue.

version

string

required

Date of the most recently updated model, formatted as YYYY-MM-DD in UTC.

models

object[]

required

The page's rows. Named models rather than items because renaming a shipped /v1 field is a breaking change. total and next_cursor are added beside it, so the page is navigable without breaking an existing client.

Show child attributes

total

integer | null

required

Always null. Counting a keyset page costs the scan this pagination exists to avoid. The key is present rather than omitted, so no client need special-case its absence.

next_cursor

string | null

required

Cursor for the next page, or null on the last.

List fleet runner events Create a workspace

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

List available models

Authorizations

Query Parameters

Response