| Header | Description |
|---|---|
Authorization | Your API key, e.g. Bearer am_live_abc123 |
X-Agentmark-App-Id | Your application ID, e.g. app_abc123 |
Creating an API Key
- Open the AgentMark dashboard
- Navigate to Settings > API Keys
- Click Create API Key
- Copy the key — it is only shown once
Making Requests
- curl
- TypeScript
- Python
Rate Limiting
API requests are rate-limited per tenant. When you exceed your rate limit, the API returns429 Too Many Requests with a Retry-After header indicating how long to wait before retrying.
Span & Storage Limits
Trace ingestion (POST /v1/traces) enforces monthly quotas depending on your plan:
- Span limit: Maximum number of spans per month
- Storage limit: Maximum storage used (certain plans only)
429 with a SPAN_LIMIT_EXCEEDED or STORAGE_CAP_EXCEEDED code
and a Retry-After header. Upgrade your plan at Settings > Billing.
Error Responses
| Status | Meaning |
|---|---|
400 | Invalid request — check the details array for field-level errors |
401 | Missing or invalid Authorization header |
403 | API key is valid but does not have access to this resource |
429 | Rate limited or plan quota exceeded |
503 | Service temporarily overloaded — retry after the interval in the Retry-After header |