We've recently updated the navigation
You can find Pipelines and Test Analytics in their own sections in the new horizontal menu bar at the top of the page.
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 support@buildkite.com if you're interested in knowing more about the other endpoints.
The current version of the Agent API is v3.
Schema
All API access is over HTTPS, and accessed from the agent.buildkite.com
domain. All data is sent as JSON.
curl https://agent.buildkite.com
{
"message":"👋"
}
Authentication
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" https://agent.buildkite.com/v3/metrics