Environments

Environments

Aurion provides two environments for development and production use.

Base URLs

Sandbox Environment

Sandbox is our staging environment (apps-staging.aurionai.net). It runs the same stack as production but is intended for testing and development. There is no separate isolated sandbox instance — point the tenant's ITSM credentials at a non-production ITSM instance if you want test isolation. Use the sandbox to:

• Test API integrations without affecting production data
• Validate webhook configurations
• Develop and debug new features

Sandbox API keys are created the same way as production keys but within the sandbox dashboard. Sandbox keys use the itsm_sk_test_… prefix; production keys use itsm_sk_live_….

Rate Limits

The API allows 300 requests per minute per API key in both production and sandbox. The limit is keyed on the API key (not per IP or per tenant), so size your concurrency around a single key accordingly.

When you exceed the rate limit, the API returns a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait, plus X-RateLimit-Limit and X-RateLimit-Remaining headers.

{
  "detail": "API key rate limit exceeded",
  "limit": 300
}

Sandbox Reset

Sandbox data can be reset to a clean state by an operator using the reset_sandbox CLI script (.venv/bin/python -m src.scripts.reset_sandbox). There is no public API endpoint for resetting sandbox data — reset is not available through an API key.

Health Checks

The environment you are talking to is identified by the base URL you call, not by a field in a response. Two unauthenticated health endpoints are available:

GET /api/v1/health is a basic liveness probe:

curl https://apps.aurionai.net/api/v1/health

{
  "status": "ok",
  "timestamp": "2026-06-09T12:34:56Z"
}

GET /api/v1/status is a richer probe that also reports dependency health:

curl https://apps.aurionai.net/api/v1/status

{
  "status": "ok",
  "timestamp": "2026-06-09T12:34:56Z",
  "dependencies": {
    "database": { "status": "ok" },
    "redis": { "status": "ok" }
  }
}

The top-level status is "degraded" if any dependency is not "ok".