Skip to main content
POST
Register a runner

Authorizations

Authorization
string
header
required

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

Body

application/json

Enrollment input. The operator ASSIGNS the policy here — the selection is an assignment the host must satisfy, not a description of the host.

host_id
string
required

Operator-supplied host identifier for this runner (1-256 chars).

Required string length: 1 - 256
assigned_policy
object
required

The policy assigned to one runner. agentsfleet delivers it to the host on enrollment and on every heartbeat. The host never declares its own policy.

labels
string[]
required

Free-form operator labels for placement/grouping.

Response

Runner registered; the bearer token is returned exactly once.

The durable runner identity plus its bearer token. The runner_token is returned exactly once; the server stores only its SHA-256 hash.

runner_id
string<uuid>
required

The minted runner's id (UUIDv7).

runner_token
string
required

The agt_r-prefixed bearer token the runner presents on every later call. Returned once; never retrievable again.

assigned_policy
object
required

The policy assigned to one runner. agentsfleet delivers it to the host on enrollment and on every heartbeat. The host never declares its own policy.