API Reference

The Aurra API is a JSON over HTTPS service. Every endpoint is REST-shaped and authenticated with a single bearer token.

Base URL

https://api.aurra.us

All requests use HTTPS. HTTP requests are redirected.

Authentication

Every request must include an Authorization header with your API key:

Authorization: Bearer aurra_your_key_here

API keys start with the aurra_ prefix and are created in your dashboard at app.aurra.us. You can have multiple keys per account; they share the same data and permissions.

Requests without a valid Authorization header return 401 Unauthorized.

$ curl https://api.aurra.us/agent/memories
{"detail":"Not authenticated"}

Response format

Successful responses return 200 OK with a JSON body. The shape differs per endpoint. Common response fields you will see across multiple endpoints:

• company_id - The Clerk user ID that owns this data
• tenant_id - The tenant scope for the request. null means default tenant
• valid_from - ISO 8601 timestamp when the fact became true
• valid_to - ISO 8601 timestamp when it stopped being true. null means still current
• superseded_by - If non-null, the ID of the memory that replaced this one

Timestamps are always UTC ISO 8601 with timezone.

Errors

Errors return a non-2xx status with a JSON body containing a detail field.

Rate limits

Rate limits are enforced per API key. Limits depend on your plan. Check current usage with GET /plan/status.

{
  "plan_tier": "starter",
  "writes_used": 49,
  "writes_limit": 50000,
  "writes_remaining": 49951,
  "in_grace_period": false,
  "blocked": false
}

Tenant scoping

Every memory belongs to a tenant_id. Pass tenant_id on writes and queries to scope data within your account - useful for separating per-customer, per-project, or per-environment data.

If you do not pass tenant_id, the request operates on the default tenant. Memories written without a tenant cannot later be moved into a tenant.

SDKs

• Python: pip install aurra
• JavaScript / TypeScript: npm install aurra

Endpoints in this reference