API Reference
Manage projects, tests, and runs programmatically with the Smoketest REST API.
The Smoketest REST API manages the reusable-Test library programmatically: create projects and Tests, compose Shared Steps, trigger Runs, and poll Results. It is versioned under /v1.
Jira and Linear Connections, Test Sources, and Test Requests are intentionally app-only in this release. Connect Jira or Linear and operate the Board in the Smoketest app; use the public API when you want to manage or run reusable Tests.
Base URL
https://api.smoketest.shAll endpoints below are relative to this base URL.
Quick example
curl https://api.smoketest.sh/v1/projects \
-H "Authorization: Bearer smkt_your_key_here"What you can do
| Resource | What you can do |
|---|---|
| Projects | Create, list, update, and delete projects |
| Tests | Manage tests and trigger runs via /v1/tests |
| Tags | Filter and run groups of reusable Tests by project tag |
| Shared Steps | Manage reusable named test snippets |
| Environments | Create and manage environment variable sets |
| Runs | List runs and fetch results |
| Schedules | Discover supported reusable-Test schedules |
| Billing | Inspect credits, usage, and plan status |
Authentication
All /v1 endpoints require an API key. See Authentication for how to create a key and authenticate requests.
Rate limits
60 requests per 60 seconds per API key. See Rate Limits for details.