API Reference

Overview

The Axiomatic API follows RESTful conventions. All endpoints accept and return JSON.

Base URL: https://app.axiomatic.software/api

Authentication

Requests require one of:

• Session cookie — set automatically when signed in via the web app
• API key — pass via the x-api-key header

curl https://app.axiomatic.software/api/entities \
  -H "x-api-key: YOUR_API_KEY"

Multi-Tenant Routing

Axiomatic uses a tenant-per-organization architecture. Each organization has its own isolated database. Most endpoints require tenant context, resolved automatically via:

1. entityId query/body parameter — maps to the correct tenant database
2. Session cookie — resolves the user's tenants from the control plane

GET /api/entities is cross-tenant — it queries all tenants the authenticated user has access to.

Endpoints

Browse the sidebar for interactive documentation on every endpoint, organized by category:

Rate Limits

API requests are rate-limited per API key. Current limits:

• 100 requests/minute for read endpoints (GET)
• 30 requests/minute for write endpoints (POST/PUT/PATCH/DELETE)

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709164800

Errors

All errors return a JSON body with an error field:

{ "error": "Entity not found" }