Skip to main content
POST
Ask for the next managed build

Authorizations

Authorization
string
header
required

Fleet machine key (olfm_*), made by a platform admin. Belongs to a machine OuterLayer operates, not to a factory.

Headers

Signature
string

HTTP Message Signature (RFC 9421) made with the runner key's host key: runner=:<base64>:.

Signature-Input
string

The signature's covered components and parameters: runner=("@method" "@path" "@query" "content-digest");created=<unix seconds>;nonce="<random>";keyid="<host key fingerprint>";alg="ed25519".

Content-Digest
string

RFC 9530 digest of the request body, always sent, including for a request with none: sha-256=:<base64>:.

Body

application/json
cliVersion
string
required
Required string length: 1 - 100
free
object
required

The room the machine has free now.

images
string[]
required

The repositories, as owner/repo, whose build images the machine holds.

Maximum array length: 500
Required string length: 1 - 255
runnerProtocol
integer
required
total
object
required

The room the machine has in all: memory in GiB, cores and disk in GB.

hostKey
string
Pattern: ^[A-Za-z0-9_-]{43}$

Response

The decision. claim is null when no build fits.

data
object
required