# Buildkite

Buildkite is a platform for running fast, secure, and scalable continuous integration pipelines on your own infrastructure.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `BUILDKITE`
- **Version:** 20260227_00

## Tools

### Get Current Access Token

**Slug:** `BUILDKITE_GET_CURRENT_ACCESS_TOKEN`

Tool to retrieve the authenticated API access token details. Use when you need to confirm the validity and scopes of the current API token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meta

**Slug:** `BUILDKITE_GET_META`

Tool to retrieve metadata about the Buildkite API. Use when you need to fetch webhook IP addresses for firewall or security configurations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `BUILDKITE_GET_USER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `BUILDKITE_LIST_ORGANIZATIONS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `per_page` | integer | No | Number of results per page (default: 30, max: 100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pipeline Agents

**Slug:** `BUILDKITE_LIST_PIPELINE_AGENTS`

Tool to list connected agents for an organization. Use after confirming the organization slug. Supports optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter results by agent name. |
| `page` | integer | No | Page number for pagination (1-based). |
| `version` | string | No | Filter results by exact agent version. |
| `hostname` | string | No | Filter results by agent hostname. |
| `org_slug` | string | Yes | The slug of the organization whose agents should be listed. |
| `per_page` | integer | No | Number of results per page (1-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |