Skip to content
TestomatoHelp & Docs

Overview

Testomato API 1.0.0

Section titled “Testomato API 1.0.0”

The Testomato REST API provides simple interfaces for the core Testomato functionality. To use this REST API, your application makes an HTTP request and parses the JSON-formatted response. Every endpoint except POST /authenticate requires an API token. To use the API from an AI assistant, see MCP server.

If you’d like to contribute to our roadmap, we’d love to hear your suggestions — support@testomato.com

Operations

Section titled “Operations”
GET
/authenticate
POST
/authenticate
GET
/project/create
POST
/project/create
GET
/project/{id}
PUT
/project/{id}
DELETE
/project/{id}
GET
/project/{id}/status
GET
/project/{id}/simple-status
GET
/project/{id}/start
GET
/project/{ProjectId}/job/{JobId}/results
GET
/project/{id}/users
POST
/project/{id}/users
DELETE
/project/{id}/users
GET
/project/{id}/roles
GET
/project/{id}/notifications
POST
/project/{id}/notifications
GET
/project/{id}/responseTimes
GET
/project/{id}/uptime
GET
/project/{id}/permissions
GET
/project/{ProjectId}/start/area/{AreaId}
GET
/project/{id}/areas
GET
/test/{id}
PUT
/test/{id}
DELETE
/test/{id}

Authentication

Section titled “Authentication”

ApiToken

Section titled “ApiToken”

Send an API token as Authorization: Bearer <token>. Create a personal access token in Account settings, or get a login token from POST /authenticate. See API tokens.

The token is a JWT.

Retired: ?apikey= in the query string. Older integrations authenticated by appending an API key to the URL. That is rejected now — the API answers API key authentication is deprecated. Switch to the JWT token instead. Use an API token instead.

Security scheme type: http

Bearer format: JWT