SandboxesTemplatesTemplate builds
Get a template build
Get one build. The id is globally unique, so this route carries no scope. Access comes from the build's template.
Authorization
apiKey AuthorizationBearer <token>
API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
buildId*string
Build ULID
Length
length <= 64Response Body
application/json
application/problem+json
curl -X GET "https://example.com/v1/template-builds/string"{ "can_cancel": true, "cancelled_by": { "display_name": "string", "id": "string", "username": "string" }, "created_at": "2019-08-24T14:15:22Z", "error": "string", "finished_at": "2019-08-24T14:15:22Z", "id": "string", "image_ref": "string", "project": { "display_name": "Online Shop", "name": "online-shop" }, "resolved_digest": "string", "started_at": "2019-08-24T14:15:22Z", "status": "pending", "steps": [ { "attempt": 0, "context": { "user": "string", "workdir": "string" }, "exit_code": 0, "finished_at": "2019-08-24T14:15:22Z", "name": "string", "run": "string", "started_at": "2019-08-24T14:15:22Z", "status": "running", "step_index": 0, "tolerated": true, "type": "string" } ], "tags_on_success": [ "string" ], "template": { "deleted": true, "display_name": "Go Development", "id": "string", "name": "go-dev" }, "version_id": "string", "wait_reason": "string"}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}Read a template build's log GET
Read a build's log, oldest first. A log is kept for seven days; the build's own status and timings outlive it.
List builds of organization templates GET
List builds, newest first. `q` matches the start of a build id, of a template name, or of the tag the build asked for. Send `q` with every page of a filtered list: the cursor carries the position, not the filter. Requires organization membership.