Skip to main content
All API endpoints (except health checks) require two headers:
HeaderDescription
AuthorizationYour API key, e.g. Bearer am_live_abc123
X-Agentmark-App-IdYour application ID, e.g. app_abc123

Creating an API Key

  1. Open the AgentMark dashboard
  2. Navigate to Settings > API Keys
  3. Click Create API Key
  4. Copy the key — it is only shown once

Making Requests

curl https://api.agentmark.co/v1/traces \
  -H "Authorization: Bearer am_live_abc123" \
  -H "X-Agentmark-App-Id: app_abc123"

Rate Limiting

API requests are rate-limited per tenant. When you exceed your rate limit, the API returns 429 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)
When exceeded, the API returns 429 with a SPAN_LIMIT_EXCEEDED or STORAGE_CAP_EXCEEDED code and a Retry-After header. Upgrade your plan at Settings > Billing.

Error Responses

StatusMeaning
400Invalid request — check the details array for field-level errors
401Missing or invalid Authorization header
403API key is valid but does not have access to this resource
429Rate limited or plan quota exceeded
503Service temporarily overloaded — retry after the interval in the Retry-After header