Fleet and Operations API

Every endpoint on this page requires the operations bearer token. These are control-plane APIs; call them from a trusted server, CLI, or automation rather than a browser.

Fleet execution

Method	Path	Purpose
`GET`	`/api/fleet/plan?threshold=50`	Preview repositories eligible for a fleet pass using worker-owned data.
`POST`	`/api/fleet/run`	Start a bounded fleet operation.
`GET`	`/api/fleet/status`	Read current caches, staging, and ledger state from the fleet worker.

curl -X POST -H "Authorization: Bearer $FL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repos":["forwardlane-backend"],"limit":1,"threshold":50,"engine":"local"}' \
  https://api.agentic.forwardlane.com/api/fleet/run

The run body accepts repos (optional repository-name array), limit, threshold, engine, and legacy modal. An omitted or empty repos array requests auto-planning. A non-empty selection that resolves to no repositories is rejected instead of widening into an auto-planned fleet run. @profile entries require FL_CONFIG.md in the API runtime; use explicit repository names for the standard Railway image. The exact operation payload varies by engine; inspect status before issuing another run. The API service must have INNGEST_BASE_URL, INNGEST_EVENT_KEY, and INNGEST_SIGNING_KEY configured for the same Inngest service as the fleet worker. Without that connection, run requests fail closed with 503. Plan and status reads are proxied server-to-server to the stateful worker. Configure FLEET_WORKER_BASE_URL on fl-api and the same server-only FLEET_STATUS_TOKEN on fl-api and fl-fleet. Without both, these reads return 503; they never substitute the stateless API container’s empty local data.

Quality, audit, and discovery

Method	Path	Key inputs	Response
`GET`	`/api/quality/history`	`repo` (required), `days`	`{repo, days, snapshots}`
`GET`	`/api/quality/current`	`repo`	Current quality node.
`POST`	`/api/quality/snapshot`	`repo`	Snapshot operation result.
`GET`	`/api/audit/timeline`	`repo`, `event_type`, `phase`, `limit`, `since`	`{repo, events, total}`
`GET`	`/api/audit/summary`	`repo`	Event counts and score progression.
`GET`	`/api/technical-discovery`	`min_coverage`, `has_ci`, `has_docker`, `language`, `limit`	`{items, total}`

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/technical-discovery?min_coverage=80&has_ci=true&limit=25"

Benchmarks

Method	Path	Key inputs
`GET`	`/api/benchmark/tasks`	`repo`, `domain`, `difficulty`, `limit`
`GET`	`/api/benchmark/tasks/{instance_id}`	Benchmark task identifier
`GET`	`/api/benchmark/eval-results`	`model`, `repo`, `limit`

List endpoints return {items, total}. Task details are the stored benchmark record.

Embedding and graph administration

Method	Path	Body or query	Notes
`POST`	`/api/embeddings/generate`	`dry_run` query flag	Runs or estimates the batch embedding pipeline.
`POST`	`/api/admin/reload-graph`	`clean` query flag	Reloads graph data; `clean=true` rebuilds it.
`POST`	`/api/graph/node`	`{label, properties}`	Creates or merges a schema-valid node.
`PATCH`	`/api/graph/node/{label}/{name}`	`{properties}`	Updates schema-valid properties.
`POST`	`/api/graph/edge`	Source, target, relationship, properties	Creates an allowlisted relationship.
`DELETE`	`/api/graph/node/{label}/{name}`	—	Removes a graph node.

Graph mutation, graph reload, and non-dry-run embedding generation affect shared operational state. Restrict them to trusted automation and follow the deployment runbook.

Get Started

Products

API Reference

CLI

FL Web

Python SDK

MCP Server

Graph Schema

Fleet and Operations

Fleet and Operations API

Fleet execution

Quality, audit, and discovery

Benchmarks

Embedding and graph administration

​Fleet and Operations API

​Fleet execution

​Quality, audit, and discovery

​Benchmarks

​Embedding and graph administration

Fleet and Operations API

Fleet execution

Quality, audit, and discovery

Benchmarks

Embedding and graph administration