Tektona Docs

List builds, newest first. Requires read access to the project.

Authorization

apiKey

AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

org*string

Organization name

project*string

Project name

Query Parameters

project?string

Narrow to one project by name. Only the project in the path is in scope, so another name returns an empty list.

Lengthlength <= 63

template?string

Narrow to one template by name

Lengthlength <= 80

q?string

Filter by build id prefix, template name prefix, or requested tag prefix.

Lengthlength <= 100

cursor?string

Continue after this build id

Lengthlength <= 64

limit?integer

Page size, 50 by default

Formatint32

Range1 <= value <= 200

Response Body

`application/json`

`application/problem+json`

curl -X GET "https://example.com/v1/orgs/string/projects/string/template-builds"

{  "items": [    {      "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",          "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"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string",    "total_count": 0  }}

{  "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"}

List builds of project templates