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

https://backend.autosana.ai
All API endpoints are relative to this base URL.

​
Authentication

All API requests require an API key passed in the X-API-Key header. 
curl -X POST https://backend.autosana.ai/api/v1/suites \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Test Suite"}'
​
X-API-Key
string
required
Your organization’s API key. Get it from Settings → Integrations.

​
Available Endpoints

Suites & Flows

Create and list test suites and flows

Runs

Trigger flows, poll for results, and fetch run details

CI/CD Upload

Upload app builds programmatically

​
Error Responses

Status CodeDescription
400Bad request - missing or invalid parameters
401Missing API key
403Invalid API key
404Resource not found
422Validation error - check the response body for details
500Server error

​
Example Error Response

{
  "detail": "Suite not found"
}

​
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