Agent REST API Overview

The Agent REST API is used for agent registration, agent deregistration, job starting and job finishing, and agent metrics. As of August 2021 the only documented end-point is /metrics. Reach out to if you're interested in knowing more about the other endpoints.

The current version of the Agent API is v3.


All API access is over HTTPS, and accessed from the domain. All data is sent as JSON.



Unlike the Buildkite REST API, which uses an API Access token, the Agent REST API uses an Agent registration token for authentication.

To authenticate using an Agent registration token, set the Authorization HTTP header to the word Token, followed by a space, followed by the access token. For example:

curl -H "Authorization: Token $TOKEN"