API Reference#

The Stora REST API gives you programmatic access to all platform features: projects, screenshots, metadata, compliance, and store submission.

Base URL#

https://stora.sh/api/v1

All endpoints are relative to this base URL.

Authentication#

Every request must include your API key in the Authorization header:

Authorization: Bearer sk_stora_...

Generate API keys at Settings > API & MCP in the Stora dashboard.

Warning: API keys grant full access to your account. Keep them secret. Use environment variables to store keys and never commit them to version control.

Request Format#

• All request bodies must be JSON with Content-Type: application/json.
• Query parameters are used for filtering and pagination.

Response Format#

All responses return JSON. Successful responses return the relevant data directly:

{
  "projects": [...]
}

Error Format#

Errors return an appropriate HTTP status code and a JSON body:

{
  "error": "Project not found"
}

Common status codes:

| Code | Meaning | |---|---| | 400 | Bad request — invalid parameters | | 401 | Unauthorized — missing or invalid API key | | 403 | Forbidden — insufficient permissions | | 404 | Not found | | 429 | Rate limit exceeded | | 500 | Internal server error |

Rate Limiting#

API requests are limited to 100 requests per minute per API key. When you exceed the limit, you will receive a 429 response with a Retry-After header indicating how many seconds to wait.

Example#

curl -H "Authorization: Bearer sk_stora_..." \
  https://stora.sh/api/v1/projects

Endpoints#

| Endpoint | Description | |---|---| | Projects | List and manage projects | | Screenshots | Generate and retrieve screenshots | | Metadata | Read and update ASO metadata | | Compliance | Run compliance scans | | Submissions | Submit to stores and check review status |