Skip to content
Latta Docs

Triggering runs

Latta offers a node based builder for testing your web apps and REST APIs.

Triggering test runs

You are going to have to obtain a project api key with at least the permission to trigger runs.

Terminal window
curl -X 'POST' \
'https://api.latta.ai/service/test-runner/v1/project-test-run/{collectionID}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {YOUR_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{}'

Be sure to replace {YOUR_API_KEY} with an actual API key for your project and {collectionID} with an actual ID of your test collection.

Environment variables

Latta tests support environment variables, these variables are sent as follows

Terminal window
curl -X 'POST' \
'https://api.latta.ai/service/test-runner/v1/project-test-run/{collectionID}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {YOUR_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
 "environment_variables":
  {"APP_URL":"http://example.com"}
}'

and you can use the Get environment variable node to load and use the value

Project Environment variable

Checking status

Terminal window
curl -X 'GET' \
'https://api.latta.ai/service/test-runner/v1/project-test-run/{collectionID}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {YOUR_API_KEY}' \

The above request might return the following response.

{
	"id":"9c40931a-27a7-4465-97f3-987665cfcdb0",
	"project_test_collection_id":"2da5cc3f-2924-4256-972c-bccffdab6a15",
	"status":"finished",
	"started_at":"2025-10-22T08:35:16.001Z",
	"finished_at":"2025-10-22T08:35:20.618Z",
	"created_at":"2025-10-22T08:35:15.959Z",
	"updated_at":"2025-10-22T08:35:20.620Z",
	"error_message":null
}

The started_at and finished_at dates might be null depending on the status of the test run.

In your CI/CD pipelines it is recommended to check just for the finished or failed states.

Cancelling runs

Terminal window
curl -X 'DELETE' \
'https://api.latta.ai/service/test-runner/v1/project-test-run/{collectionID}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {YOUR_API_KEY}' \

Runs can be cancelled only when they are in the queued or running states.