SandboxesSandbox TemplatesTemplate management

List project templates

List the templates the project can create from. Three groups, in order: the project's own templates, then the organization's, then the platform's tektona/<name> catalogue. Each group is in name order. A project and its organization may both hold one name, so read scope, not the name alone. q matches the start of a name, or a word in the display name or description. Send q with every page of a filtered list: the cursor carries the position, not the filter. Requires read access to the project.

GET
/v1/orgs/{org}/projects/{project}/templates

List the templates the project can create from. Three groups, in order: the project's own templates, then the organization's, then the platform's tektona/<name> catalogue. Each group is in name order. A project and its organization may both hold one name, so read scope, not the name alone. q matches the start of a name, or a word in the display name or description. Send q with every page of a filtered list: the cursor carries the position, not the filter. Requires read access to the project.

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

q?string

Filter by name prefix, or by a word in the display name or description.

Lengthlength <= 80
cursor?string

Continue after this page

Lengthlength <= 512
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/templates"
{  "items": [    {      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "metadata": {        "description": "string",        "display_name": "string",        "name": "string"      },      "reference": "go-dev",      "scope": "system",      "state": "active",      "stats": {        "builds": {          "failed": 2,          "succeeded": 5,          "total": 8        },        "sandboxes": 3,        "stored_bytes": 4187725824,        "tags": 2,        "versions": {          "active": 3,          "archived": 4        }      },      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string",    "total_count": 0  }}