NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Buildkite connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Buildkite actions, such as "Get Current Access Token", "Get Meta" and "Get User". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Buildkite, with input parameters and output schema.
BUILDKITE_GET_CURRENT_ACCESS_TOKENTool to retrieve the authenticated API access token details. Use when you need to confirm the validity and scopes of the current API token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUILDKITE_GET_METATool to retrieve metadata about the Buildkite API. Use when you need to fetch webhook IP addresses for firewall or security configurations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUILDKITE_GET_USERTool to retrieve details about the current authenticated user. Use when you need to get information about the user account that owns the API token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUILDKITE_LIST_ORGANIZATIONSTool to list all organizations the current user is a member of. Use when you need to discover available organizations or get organization slugs for other operations.
Input parameters
Page number for pagination (1-based).
Number of results per page (default: 30, max: 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUILDKITE_LIST_PIPELINE_AGENTSTool to list connected agents for an organization. Use after confirming the organization slug. Supports optional filtering and pagination.
Input parameters
Filter results by agent name.
Page number for pagination (1-based).
Filter results by exact agent version.
Filter results by agent hostname.
The slug of the organization whose agents should be listed.
Number of results per page (1-100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Buildkite actions on Nagent, including "Get Current Access Token", "Get Meta" and "Get User". Get Current Access Token: Retrieve the authenticated API access token details. Each action is listed on this page with its input parameters and its output.
Buildkite connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.