Template

This endpoint is used to create, update, search or delete teamplates inside an organization.

Entity fields:

Path	Type	Description
data.type	string	Should be "template"
data.attributes.tcl	string	Terraform Configuration Language job template
data.attribute.name	string	Template name
data.attribute.description	string	Template description
data.attribute.version	string	Template version

To better understand Terrakube Configuration Language job templates please refer to the following GitHub repository.

Example:

{
  "data": {
    "type": "template",
    "attributes": {
      "name": "Some name",
      "description": "Some description",
      "version": "1.0.0",
      "tcl": "{{templateSample}}"
    }
  }
}

Supported Operations

get

Returns an instance of type template

Path parameters

organizationIdanyrequired

organization Identifier

templateIdanyrequired

template Identifier

Query parameters

fields[template]anyoptional

Selects the set of template fields that should be returned in the result.

includeanyoptional

Selects the set of relationships that should be expanded as a compound document in the result.

Responses

application/vnd.api+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/organization/{organizationId}/template/{templateId}'

200

200

{
  "data": {
    "type": "text",
    "id": "text",
    "attributes": {
      "createdBy": "text",
      "createdDate": "2025-04-02T10:16:56.713Z",
      "description": "text",
      "name": "text",
      "tcl": "text",
      "updatedBy": "text",
      "updatedDate": "2025-04-02T10:16:56.713Z",
      "version": "text"
    },
    "relationships": {
      "organization": {
        "id": "text",
        "type": "organization"
      }
    }
  },
  "included": [
    {
      "attributes": {},
      "id": "text",
      "relationships": {},
      "type": "text"
    }
  ]
}

Successful response

post

Creates an item of type template and adds it to template

Path parameters

organizationIdanyrequired

organization Identifier

Body

dataobjectoptional

Responses

application/vnd.api+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/organization/{organizationId}/template' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
    "data": {
      "type": "text",
      "id": "text",
      "attributes": {
        "createdBy": "text",
        "createdDate": "2025-04-02T10:16:56.713Z",
        "description": "text",
        "name": "text",
        "tcl": "text",
        "updatedBy": "text",
        "updatedDate": "2025-04-02T10:16:56.713Z",
        "version": "text"
      },
      "relationships": {
        "organization": {
          "id": "text",
          "type": "organization"
        }
      }
    }
  }'

201

201

{
  "data": {
    "type": "text",
    "id": "text",
    "attributes": {
      "createdBy": "text",
      "createdDate": "2025-04-02T10:16:56.713Z",
      "description": "text",
      "name": "text",
      "tcl": "text",
      "updatedBy": "text",
      "updatedDate": "2025-04-02T10:16:56.713Z",
      "version": "text"
    },
    "relationships": {
      "organization": {
        "id": "text",
        "type": "organization"
      }
    }
  }
}

Successful response

delete

Deletes an instance of type template

Path parameters

organizationIdanyrequired

organization Identifier

templateIdanyrequired

template Identifier

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/organization/{organizationId}/template/{templateId}'

204

204

No body

Successful response

patch

Modifies an instance of type template

Path parameters

organizationIdanyrequired

organization Identifier

templateIdanyrequired

template Identifier

Body

dataobjectoptional

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/organization/{organizationId}/template/{templateId}' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
    "data": {
      "type": "text",
      "id": "text",
      "attributes": {
        "createdBy": "text",
        "createdDate": "2025-04-02T10:16:56.713Z",
        "description": "text",
        "name": "text",
        "tcl": "text",
        "updatedBy": "text",
        "updatedDate": "2025-04-02T10:16:56.713Z",
        "version": "text"
      },
      "relationships": {
        "organization": {
          "id": "text",
          "type": "organization"
        }
      }
    }
  }'

204

204

No body

Successful response

For a complete list of organization operation please visit the OpenAPI specification