Build API
Container image building
REST API endpoints for Build. 5 operations.
List builds
plaintext
GET /v1/buildReturns the builds for the caller's project.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Build list |
401 | Missing or invalid API key |
500 | Internal error |
operationId: listBuilds
Start a build
plaintext
POST /v1/buildStarts a container image build and returns the build record.
Auth: Bearer API key
Request body
application/json (required) — schema object.
Responses
| Status | Description |
|---|---|
200 | Build started |
401 | Missing or invalid API key |
500 | Internal error |
operationId: createBuild
Get a build
plaintext
GET /v1/build/{id}Returns a single build by id.
Auth: Bearer API key
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Build id |
Responses
| Status | Description |
|---|---|
200 | Build details |
401 | Missing or invalid API key |
500 | Internal error |
operationId: getBuild
Cancel a build
plaintext
POST /v1/build/{id}/cancelCancels an in-progress build.
Auth: Bearer API key
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Build id |
Responses
| Status | Description |
|---|---|
200 | Build cancelled |
401 | Missing or invalid API key |
500 | Internal error |
operationId: cancelBuild
Get build logs
plaintext
GET /v1/build/{id}/logsReturns log output for a build.
Auth: Bearer API key
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Build id |
Responses
| Status | Description |
|---|---|
200 | Build logs |
401 | Missing or invalid API key |
500 | Internal error |
operationId: getBuildLogs