Templates /
List templates
Required permission
Account > Templates > General > Read
Query parameters
per_page
integerThe number of results to display per request. Maximum of 100 results per page.
page
integerThe page number to access.
cursor
stringThe cursor returned from the previous page of results, used to request the next page.
Response body
- {object}
Response object.
data
{object} requiredResult data.
templates
[array] requiredAn array of template objects.
- {object}
name
string requiredName of the template.
min length3max length39pattern^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$description
stringDescription of the template.
max length200pattern^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$apiVersion
string requiredThe version of the Northflank API to run the template against.
one ofv1id
string requiredIdentifier for the template
concurrencyPolicy
stringDefines the concurrency behaviour of the template with respect to parallel runs.
one ofallow, queue, forbidcreatedAt
stringtime of creation
updatedAt
stringtime of update
pagination
{object} requiredData about the endpoint pagination.
hasNextPage
boolean requiredIs there another page of results available?
cursor
stringThe cursor to access the next page of results.
count
number requiredThe number of results returned by this request.
GET /v1/templates
Example response
200 OK
JSON
{
"data": {
"templates": [
{
"name": "Example Template",
"description": "This is a sample template.",
"apiVersion": "v1",
"id": "example-template",
"concurrencyPolicy": "allow"
}
]
},
"pagination": {
"hasNextPage": false,
"count": 1
}
}