Skip to main content
The Autosana API allows you to programmatically create test suites, flows, and upload app builds. This is useful for integrating Autosana with your own automation platforms, AI agents, or CI/CD pipelines.
For a simpler CI/CD setup using GitHub Actions, see CI/CD Integration. The endpoints below are for custom integrations.

​
Base URL

All API endpoints are relative to this base URL.

​
Authentication

All API requests require an API key passed in the X-API-Key header.
​
string
required
Your organization’s API key. Get it from the welcome quickstart or Settings → Integrations.

​
Available Endpoints

Apps

List apps and manage default Chrome extension dependencies

Suites & Flows

Create and list test suites and flows

Labels

Manage labels, attach them to flows/suites, and run by label

Runs

Trigger flows, poll for results, and fetch run details

Hooks

Manage setup, teardown, and runtime hook scripts

Environment Variables

List environments and manage their env vars (including secrets)

CI/CD Upload

Upload app builds programmatically

​
Error Responses

​
Example Error Response

​
Rate Limits

The API is rate-limited to prevent abuse. If you receive a 429 Too Many Requests response, wait a few seconds before retrying.

​
Use Cases

AI Test Generation

Generate test cases from requirements using AI, then push them to Autosana via the API

JIRA Integration

Automatically create test suites when tickets move to “Ready for QA” status

Test Sync

Keep Autosana tests in sync with your test management system

Bulk Import

Migrate existing test cases from spreadsheets or other tools

​
Need Help?

Writing Effective Tests

Learn how to write clear, reliable test instructions

Contact Support

Reach out if you need help with your integration