Testkube Agent /test-suite-executions operations

• postStarts new test suite executions
• getGet all test suite executions
• getGet test suite execution by ID
• patchAborts testsuite execution
• getGet test suite execution artifacts

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

Starts new test suite executions

New test suite executions returns new executions details on successful executions start

query Parameters

namespace	string Default: "testkube" Namespace of the object
selector	string Labels to filter by
concurrency	integer Default: 10

Request Body schema: application/json

required

body passed to configure executions

name	string test execution custom name
number	integer test suite execution number
namespace	string test kubernetes namespace ("testkube" when not set)
	object (Variables) execution variables passed to executor converted to vars for usage in tests
	object test suite labels
	object execution labels
sync	boolean whether to start execution sync or async
httpProxy	string http proxy for executor containers
httpsProxy	string https proxy for executor containers
timeout	integer <int32> duration in seconds the test suite may be active, until its stopped
	object (TestContentRequest) test content request body
	object (RunningContext) running context for test or test suite execution
jobTemplate	string job template extensions
jobTemplateReference	string name of the template resource
cronJobTemplate	string cron job template extensions
cronJobTemplateReference	string name of the template resource
scraperTemplate	string scraper template extensions
scraperTemplateReference	string name of the template resource
pvcTemplate	string pvc template extensions
pvcTemplateReference	string name of the template resource
concurrencyLevel	integer <int32> number of tests run in parallel
testSuiteExecutionName	string test suite execution name started the test suite execution
disableWebhooks	boolean Default: false whether webhooks on the execution of this test suite are disabled

Responses

Testkube Cloud API Endpoint

https://api.testkube.io/test-suite-executions

Testkube On-Prem API Endpoint

https://<your-testkube-api-host>/test-suite-executions

Request samples

• Payload

Content type

application/json

{

• "name": "testing with 1000 users",
• "number": 1,
• "namespace": "testkube",
• "variables": {

  • "var1": {

    • "name": "var1",
    • "type": "basic",
    • "value": "value1"

    },
  • "secret1": {

    • "name": "secret1",
    • "type": "secret",
    • "value": "secretvalue1"

    }

  },
• "labels": {

  • "users": "3",
  • "prefix": "some-"

  },
• "executionLabels": {

  • "users": "3",
  • "prefix": "some-"

  },
• "sync": true,
• "httpProxy": "user:pass@my.proxy.server:8080",
• "httpsProxy": "user:pass@my.proxy.server:8081",
• "timeout": 1,
• "contentRequest": {

  • "repository": {

    • "branch": "main",
    • "commit": "b928cbb7186944ab9275937ec1ac3d3738ca2e1d",
    • "path": "test/perf",
    • "workingDir": "/"

    }

  },
• "runningContext": {

  • "type": "userCLI",
  • "context": "string"

  },
• "jobTemplate": "string",
• "jobTemplateReference": "string",
• "cronJobTemplate": "string",
• "cronJobTemplateReference": "string",
• "scraperTemplate": "string",
• "scraperTemplateReference": "string",
• "pvcTemplate": "string",
• "pvcTemplateReference": "string",
• "concurrencyLevel": 10,
• "testSuiteExecutionName": "string",
• "disableWebhooks": [

  • true,
  • false

  ]

}

Response samples

• 201
• 400
• 500
• 502

Content type

application/json

[

• {

  • "totals": {

    • "results": 0,
    • "passed": 0,
    • "failed": 0,
    • "queued": 0,
    • "running": 0

    },
  • "filtered": {

    • "results": 0,
    • "passed": 0,
    • "failed": 0,
    • "queued": 0,
    • "running": 0

    },
  • "results": [

    • {

      • "id": "62f395e004109209b50edfc1",
      • "name": "test-suite1.needlessly-sweet-imp",
      • "testSuiteName": "test-suite1",
      • "status": "queued",
      • "startTime": "2019-08-24T14:15:22Z",
      • "endTime": "2019-08-24T14:15:22Z",
      • "duration": "00:00:09",
      • "durationMs": 9009,
      • "execution": [

        • {

          • "execute": [

            • {

              • "id": "62f395e004109209b50edfc4",
              • "name": "run:testkube/test1",
              • "testName": "test1",
              • "status": "queued",
              • "type": "executeTest"

              }

            ]

          }

        ],
      • "labels": {

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

        }

      }

    ]

  }

]

Get all test suite executions

Returns array of test suite executions

query Parameters

last	integer Default: 7 last N days to show
test	string Default: "" test namespaced name to filter
textSearch	string Default: "" text to search in name and test name
pageSize	integer Default: 100 the number of executions to get, setting to 0 will return only totals
page	integer Default: 0 the page index to start at
status	string (TestSuiteExecutionStatus) Enum: "queued" "running" "passed" "failed" "aborting" "aborted" "timeout" optional status filter containing multiple values separated by comma
startDate	string <date> startDate for filtering in ISO-8601 format, i.e. "yyyy-mm-dd"
endDate	string <date> endDate for filtering
selector	string Labels to filter by

Responses

Testkube Cloud API Endpoint

https://api.testkube.io/test-suite-executions

Testkube On-Prem API Endpoint

https://<your-testkube-api-host>/test-suite-executions

Response samples

• 200
• 500

Content type

application/json

{

• "totals": {

  • "results": 0,
  • "passed": 0,
  • "failed": 0,
  • "queued": 0,
  • "running": 0

  },
• "filtered": {

  • "results": 0,
  • "passed": 0,
  • "failed": 0,
  • "queued": 0,
  • "running": 0

  },
• "results": [

  • {

    • "id": "62f395e004109209b50edfc1",
    • "name": "test-suite1.needlessly-sweet-imp",
    • "testSuiteName": "test-suite1",
    • "status": "queued",
    • "startTime": "2019-08-24T14:15:22Z",
    • "endTime": "2019-08-24T14:15:22Z",
    • "duration": "00:00:09",
    • "durationMs": 9009,
    • "execution": [

      • {

        • "execute": [

          • {

            • "id": "62f395e004109209b50edfc4",
            • "name": "run:testkube/test1",
            • "testName": "test1",
            • "status": "queued",
            • "type": "executeTest"

            }

          ]

        }

      ],
    • "labels": {

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

      }

    }

  ]

}

Get test suite execution by ID

Returns test suite execution with given executionID

path Parameters

executionID required

string unique id of the object execution

query Parameters

last	integer Default: 7 last N days to show

Responses

Testkube Cloud API Endpoint

https://api.testkube.io/test-suite-executions/{executionID}

Testkube On-Prem API Endpoint

https://<your-testkube-api-host>/test-suite-executions/{executionID}

Response samples

• 200
• 500

Content type

application/json

{

• "id": "62f395e004109209b50edfc1",
• "name": "test-suite1.needlessly-sweet-imp",
• "testSuite": {

  • "namespace": "testkube",
  • "name": "name"

  },
• "status": "queued",
• "envs": {

  • "record": "true",
  • "prefix": "some-"

  },
• "variables": {

  • "var1": {

    • "name": "var1",
    • "type": "basic",
    • "value": "value1"

    },
  • "secret1": {

    • "name": "secret1",
    • "type": "secret",
    • "value": "secretvalue1"

    }

  },
• "secretUUID": "7934600f-b367-48dd-b981-4353304362fb",
• "startTime": "2019-08-24T14:15:22Z",
• "endTime": "2019-08-24T14:15:22Z",
• "duration": "2m",
• "durationMs": 6000,
• "stepResults": [

  • {

    • "step": {

      • "stopTestOnFailure": true,
      • "execute": {

        • "namespace": "testkube",
        • "name": "name"

        },
      • "delay": {

        • "duration": 0

        }

      },
    • "test": {

      • "namespace": "testkube",
      • "name": "name"

      },
    • "execution": {

      • "id": "62f395e004109209b50edfc4",
      • "testName": "example-test",
      • "testSuiteName": "test-suite1",
      • "testNamespace": "testkube",
      • "testType": "postman/collection",
      • "name": "test-suite1-example-test-1",
      • "number": 1,
      • "envs": {

        • "record": "true",
        • "prefix": "some-"

        },
      • "command": [

        • "curl"

        ],
      • "args": [

        • "--concurrency",
        • "2",
        • "--remote",
        • "--some",
        • "blabla"

        ],
      • "args_mode": "append",
      • "variables": {

        • "var1": {

          • "name": "var1",
          • "type": "basic",
          • "value": "value1"

          },
        • "secret1": {

          • "name": "secret1",
          • "type": "secret",
          • "value": "secretvalue1"

          }

        },
      • "isVariablesFileUploaded": false,
      • "variablesFile": "string",
      • "testSecretUUID": "7934600f-b367-48dd-b981-4353304362fb",
      • "testSuiteSecretUUID": "7934600f-b367-48dd-b981-4353304362fb",
      • "content": {

        • "type": "string",
        • "repository": {

          • "type": "git",
          • "uri": "https://github.com/kubeshop/testkube",
          • "branch": "main",
          • "commit": "b928cbb7186944ab9275937ec1ac3d3738ca2e1d",
          • "path": "test/perf",
          • "username": "string",
          • "token": "string",
          • "usernameSecret": {

            • "namespace": "string",
            • "name": "string",
            • "key": "string"

            },
          • "tokenSecret": {

            • "namespace": "string",
            • "name": "string",
            • "key": "string"

            },
          • "certificateSecret": "string",
          • "workingDir": "/",
          • "authType": "basic"

          },
        • "data": "string",
        • "uri": "https://github.com/kubeshop/testkube"

        },
      • "startTime": "2019-08-24T14:15:22Z",
      • "endTime": "2019-08-24T14:15:22Z",
      • "duration": "88s",
      • "durationMs": 10000,
      • "executionResult": {

        • "status": "queued",
        • "output": "string",
        • "outputType": "text/plain",
        • "errorMessage": "string",
        • "steps": [

          • {

            • "name": "step1",
            • "duration": "10m0s",
            • "status": "passed",
            • "assertionResults": [

              • {

                • "name": "assertion1",
                • "status": "passed",
                • "errorMessage": "string"

                }

              ]

            }

          ],
        • "reports": {

          • "junit": "string"

          }

        },
      • "labels": {

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

        },
      • "uploads": [

        • "settings/config.txt"

        ],
      • "bucketName": "execution-c01d7cf6-ec3f-47f0-9556-a5d6e9009a43",
      • "artifactRequest": {

        • "storageClassName": "artifact-volume-local",
        • "volumeMountPath": "string",
        • "dirs": [

          • "string"

          ],
        • "masks": [

          • "string"

          ],
        • "storageBucket": "test1-artifacts",
        • "omitFolderPerExecution": true,
        • "sharedBetweenPods": true,
        • "useDefaultStorageClassName": true,
        • "sidecarScraper": true

        },
      • "preRunScript": "echo -n '$SECRET_ENV' > ./secret_file",
      • "postRunScript": "sleep 30",
      • "executePostRunScriptBeforeScraping": true,
      • "sourceScripts": true,
      • "runningContext": {

        • "type": "userCLI",
        • "context": "string"

        },
      • "containerShell": "/bin/sh",
      • "testExecutionName": "string",
      • "downloadArtifactExecutionIDs": [

        • "string"

        ],
      • "downloadArtifactTestNames": [

        • "string"

        ],
      • "slavePodRequest": {

        • "resources": {

          • "requests": {

            • "cpu": "250m",
            • "memory": "64Mi"

            },
          • "limits": {

            • "cpu": "250m",
            • "memory": "64Mi"

            }

          },
        • "podTemplate": "string",
        • "podTemplateReference": "string"

        },
      • "executionNamespace": "string",
      • "disableWebhooks": [

        • true,
        • false

        ]

      }

    }

  ],
• "executeStepResults": [

  • {

    • "step": {

      • "stopOnFailure": true,
      • "downloadArtifacts": {

        • "allPreviousSteps": false,
        • "previousStepNumbers": [

          • 0

          ],
        • "previousTestNames": [

          • "string"

          ]

        },
      • "execute": [

        • {

          • "test": "name",
          • "delay": "1s",
          • "executionRequest": {

            • "executionLabels": {

              • "users": "3",
              • "prefix": "some-"

              },
            • "variables": {

              • "var1": {

                • "name": "var1",
                • "type": "basic",
                • "value": "value1"

                },
              • "secret1": {

                • "name": "secret1",
                • "type": "secret",
                • "value": "secretvalue1"

                }

              },
            • "command": [

              • "curl"

              ],
            • "args": [

              • "--repeats",
              • "5",
              • "--insecure"

              ],
            • "args_mode": "append",
            • "sync": true,
            • "httpProxy": "user:pass@my.proxy.server:8080",
            • "httpsProxy": "user:pass@my.proxy.server:8081",
            • "negativeTest": false,
            • "jobTemplate": "string",
            • "jobTemplateReference": "string",
            • "cronJobTemplate": "string",
            • "cronJobTemplateReference": "string",
            • "scraperTemplate": "string",
            • "scraperTemplateReference": "string",
            • "pvcTemplate": "string",
            • "pvcTemplateReference": "string",
            • "runningContext": {

              • "type": "userCLI",
              • "context": "string"

              },
            • "disableWebhooks": [

              • true,
              • false

              ]

            }

          }

        ]

      },
    • "execute": [

      • {

        • "step": {

          • "test": "name",
          • "delay": "1s",
          • "executionRequest": {

            • "executionLabels": {

              • "users": "3",
              • "prefix": "some-"

              },
            • "variables": {

              • "var1": {

                • "name": "var1",
                • "type": "basic",
                • "value": "value1"

                },
              • "secret1": {

                • "name": "secret1",
                • "type": "secret",
                • "value": "secretvalue1"

                }

              },
            • "command": [

              • "curl"

              ],
            • "args": [

              • "--repeats",
              • "5",
              • "--insecure"

              ],
            • "args_mode": "append",
            • "sync": true,
            • "httpProxy": "user:pass@my.proxy.server:8080",
            • "httpsProxy": "user:pass@my.proxy.server:8081",
            • "negativeTest": false,
            • "jobTemplate": "string",
            • "jobTemplateReference": "string",
            • "cronJobTemplate": "string",
            • "cronJobTemplateReference": "string",
            • "scraperTemplate": "string",
            • "scraperTemplateReference": "string",
            • "pvcTemplate": "string",
            • "pvcTemplateReference": "string",
            • "runningContext": {

              • "type": "userCLI",
              • "context": "string"

              },
            • "disableWebhooks": [

              • true,
              • false

              ]

            }

          },
        • "test": {

          • "namespace": "testkube",
          • "name": "name"

          },
        • "execution": {

          • "id": "62f395e004109209b50edfc4",
          • "testName": "example-test",
          • "testSuiteName": "test-suite1",
          • "testNamespace": "testkube",
          • "testType": "postman/collection",
          • "name": "test-suite1-example-test-1",
          • "number": 1,
          • "envs": {

            • "record": "true",
            • "prefix": "some-"

            },
          • "command": [

            • "curl"

            ],
          • "args": [

            • "--concurrency",
            • "2",
            • "--remote",
            • "--some",
            • "blabla"

            ],
          • "args_mode": "append",
          • "variables": {

            • "var1": {

              • "name": "var1",
              • "type": "basic",
              • "value": "value1"

              },
            • "secret1": {

              • "name": "secret1",
              • "type": "secret",
              • "value": "secretvalue1"

              }

            },
          • "isVariablesFileUploaded": false,
          • "variablesFile": "string",
          • "testSecretUUID": "7934600f-b367-48dd-b981-4353304362fb",
          • "testSuiteSecretUUID": "7934600f-b367-48dd-b981-4353304362fb",
          • "content": {

            • "type": "string",
            • "repository": {

              • "type": "git",
              • "uri": "https://github.com/kubeshop/testkube",
              • "branch": "main",
              • "commit": "b928cbb7186944ab9275937ec1ac3d3738ca2e1d",
              • "path": "test/perf",
              • "username": "string",
              • "token": "string",
              • "usernameSecret": {

                • "namespace": "string",
                • "name": "string",
                • "key": "string"

                },
              • "tokenSecret": {

                • "namespace": "string",
                • "name": "string",
                • "key": "string"

                },
              • "certificateSecret": "string",
              • "workingDir": "/",
              • "authType": "basic"

              },
            • "data": "string",
            • "uri": "https://github.com/kubeshop/testkube"

            },
          • "startTime": "2019-08-24T14:15:22Z",
          • "endTime": "2019-08-24T14:15:22Z",
          • "duration": "88s",
          • "durationMs": 10000,
          • "executionResult": {

            • "status": "queued",
            • "output": "string",
            • "outputType": "text/plain",
            • "errorMessage": "string",
            • "steps": [

              • {

                • "name": "step1",
                • "duration": "10m0s",
                • "status": "passed",
                • "assertionResults": [

                  • null

                  ]

                }

              ],
            • "reports": {

              • "junit": "string"

              }

            },
          • "labels": {

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

            },
          • "uploads": [

            • "settings/config.txt"

            ],
          • "bucketName": "execution-c01d7cf6-ec3f-47f0-9556-a5d6e9009a43",
          • "artifactRequest": {

            • "storageClassName": "artifact-volume-local",
            • "volumeMountPath": "string",
            • "dirs": [

              • "string"

              ],
            • "masks": [

              • "string"

              ],
            • "storageBucket": "test1-artifacts",
            • "omitFolderPerExecution": true,
            • "sharedBetweenPods": true,
            • "useDefaultStorageClassName": true,
            • "sidecarScraper": true

            },
          • "preRunScript": "echo -n '$SECRET_ENV' > ./secret_file",
          • "postRunScript": "sleep 30",
          • "executePostRunScriptBeforeScraping": true,
          • "sourceScripts": true,
          • "runningContext": {

            • "type": "userCLI",
            • "context": "string"

            },
          • "containerShell": "/bin/sh",
          • "testExecutionName": "string",
          • "downloadArtifactExecutionIDs": [

            • "string"

            ],
          • "downloadArtifactTestNames": [

            • "string"

            ],
          • "slavePodRequest": {

            • "resources": {

              • "requests": {

                • "cpu": "250m",
                • "memory": "64Mi"

                },
              • "limits": {

                • "cpu": "250m",
                • "memory": "64Mi"

                }

              },
            • "podTemplate": "string",
            • "podTemplateReference": "string"

            },
          • "executionNamespace": "string",
          • "disableWebhooks": [

            • true,
            • false

            ]

          }

        }

      ],
    • "startTime": "2019-08-24T14:15:22Z",
    • "endTime": "2019-08-24T14:15:22Z",
    • "duration": "2m"

    }

  ],
• "labels": {

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

  },
• "runningContext": {

  • "type": "userCLI",
  • "context": "string"

  },
• "testSuiteExecutionName": "string",
• "disableWebhooks": [

  • true,
  • false

  ]

}

Aborts testsuite execution

Aborts testsuite execution with given executionID

path Parameters

executionID required

string unique id of the object execution

Responses

Testkube Cloud API Endpoint

https://api.testkube.io/test-suite-executions/{executionID}

Testkube On-Prem API Endpoint

https://<your-testkube-api-host>/test-suite-executions/{executionID}

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"

  }

]

Get test suite execution artifacts

Returns test suite execution artifacts with given executionID

path Parameters

executionID required

string unique id of the object execution

Responses

Testkube Cloud API Endpoint

https://api.testkube.io/test-suite-executions/{executionID}/artifacts

Testkube On-Prem API Endpoint

https://<your-testkube-api-host>/test-suite-executions/{executionID}/artifacts

Response samples

• 200
• 500

Content type

application/json

{

• "name": "string",
• "size": 0,
• "executionName": "test-1",
• "status": "ready"

}