Testkube Agent /templates operations

• getList templates
• postCreate new template
• delDelete templates
• delDelete template
• getGet template details
• patchUpdate new template

API docs by Redocly

Testkube API (1.0.0)

Download OpenAPI specification:Download

E-mail: testkube@kubeshop.io License: MIT

Testkube provides a Kubernetes-native framework for test definition, execution and results

List templates

List templates available in cluster

query Parameters

selector

string Labels to filter by

Responses

https://raw.githubusercontent.com/templates

Response samples

• 200
• 400
• 502

Content type

application/jsontext/yamlapplication/json

[

• {

  • "name": "webhook-template",
  • "namespace": "testkube",
  • "type": "job",
  • "body": "{\"id\": \"{{ .Id }}\"}",
  • "labels": {

    • "env": "prod",
    • "app": "backend"

    }

  }

]

Create new template

Create new template based on variables passed in request

Request Body schema:

application/jsontext/yamlapplication/json

required

template request body data

name required	string template name for reference
namespace	string template namespace
type required	string (TemplateType) Enum: "job" "container" "cronjob" "scraper" "pvc" "webhook" "pod" template type by purpose
body required	string template body to use
	object template labels

Responses

https://raw.githubusercontent.com/templates

Request samples

• Payload

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook-template",
• "namespace": "testkube",
• "type": "job",
• "body": "{\"id\": \"{{ .Id }}\"}",
• "labels": {

  • "env": "prod",
  • "app": "backend"

  }

}

Response samples

• 201
• 400
• 502

Content type

application/json

{

• "name": "webhook-template",
• "namespace": "testkube",
• "type": "job",
• "body": "{\"id\": \"{{ .Id }}\"}",
• "labels": {

  • "env": "prod",
  • "app": "backend"

  }

}

Delete templates

Deletes labeled templates

query Parameters

selector

string Labels to filter by

Responses

https://raw.githubusercontent.com/templates

Response samples

• 502

Content type

application/problem+json

[

• {

  • "type": "https://kubeshop.io/testkube/problems/invalidtestname",
  • "title": "Invalid test name",
  • "status": 500,
  • "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
  • "instance": "http://10.23.23.123:8088/tests"

  }

]

Delete template

Deletes template by its name

path Parameters

id required

string unique id of the object

Responses

https://raw.githubusercontent.com/templates/{id}

Response samples

• 404
• 502

Content type

application/problem+json

[

• {

  • "type": "https://kubeshop.io/testkube/problems/invalidtestname",
  • "title": "Invalid test name",
  • "status": 500,
  • "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
  • "instance": "http://10.23.23.123:8088/tests"

  }

]

Get template details

Returns template

path Parameters

id required

string unique id of the object

Responses

https://raw.githubusercontent.com/templates/{id}

Response samples

• 200
• 400
• 404
• 500
• 502

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook-template",
• "namespace": "testkube",
• "type": "job",
• "body": "{\"id\": \"{{ .Id }}\"}",
• "labels": {

  • "env": "prod",
  • "app": "backend"

  }

}

Update new template

Update new template based on variables passed in request

path Parameters

id required

string unique id of the object

Request Body schema:

application/jsontext/yamlapplication/json

required

template request body data

name required	string template name for reference
namespace	string template namespace
type required	string (TemplateType) Enum: "job" "container" "cronjob" "scraper" "pvc" "webhook" "pod" template type by purpose
body required	string template body to use
	object template labels

Responses

https://raw.githubusercontent.com/templates/{id}

Request samples

• Payload

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook-template",
• "namespace": "testkube",
• "type": "job",
• "body": "{\"id\": \"{{ .Id }}\"}",
• "labels": {

  • "env": "prod",
  • "app": "backend"

  }

}

Response samples

• 200
• 400
• 404
• 502

Content type

application/json

{

• "name": "webhook-template",
• "namespace": "testkube",
• "type": "job",
• "body": "{\"id\": \"{{ .Id }}\"}",
• "labels": {

  • "env": "prod",
  • "app": "backend"

  }

}