Skip to main content
If you need to trigger test execution from outside our app, you can do it with a cURL command. You can retrieve it conveniently with prefilled parameters from within the app by click on run in the test report section.
Run tests button in the Octomind app

Run tests button in the Octomind app - 09/2025

In the one-time run tab, you’ll find the run in terminal button. Click on it.
Run in terminal butto

Run in terminal button - 09/2025

cURL command to run your test suite

cURL command to run your test suite, 09/2025

The command will return a response with a link to your test report and some other information, see the API Reference. 
{ "testReportUrl": "https://app.octomind.dev/testreports/<some-id>",
  "testReport":  { "id":  "<someUUID>", "status": "<WAITING|PASSED|FAILED>"}
}
If you follow this link, you can find the test report containing all test results of your execution.

​
Parameters

See API Reference

​
Blocking your pipeline

You can block your pipeline by polling the resulting test-report until the status is “PASSED” with a call to the test report API - see our API Reference. See the API Reference or a reference implementation in our Github Action

​
Create an API key

The option to create your API key can be found within the settings menu.
Account settings menu icon

Account settings menu icon, 5/2025

Click on Create an API key.
Link to create an API key in the Octomind app

Create an API key button, 05/2025

You then will be navigated to our auth provider where you can create a new organization-level API key.
Create a new Octomind API key in the settings

Create a new Octomind API key in the settings, 05/2025

Copy the Octomind API key

Copy the Octomind API key

You can only copy the API key once, so make sure to do that now. You should not share it with anyone.
Add the API key to your CI provider as a secret to run test reports from the CI. Watch this this video for more insight on how to run Octomind tests: