Authentication

Documentation Index

Fetch the complete documentation index at: https://docs.agentmark.co/llms.txt

Use this file to discover all available pages before exploring further.

​

Creating an API key

1. Open the AgentMark Dashboard
2. Switch to the app you want to scope the key to (shown in the breadcrumb)
3. Navigate to the app’s Settings → API keys page (app-level, not org-level)
4. Click Create API key
5. Select a role (SDK, Read-Only, or Full Access) or choose Custom to toggle individual permissions
6. Copy the key — it is only shown once

​

Endpoint permissions

​

Traces and spans

​

Sessions

​

Scores

​

Metrics, datasets, experiments, prompts

​

Annotation queues

​

Unauthenticated

​

Making requests

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

const response = await fetch("https://api.agentmark.co/v1/traces", {
  headers: {
    "Authorization": `Bearer ${process.env.AGENTMARK_API_KEY}`,
    "X-Agentmark-App-Id": process.env.AGENTMARK_APP_ID!,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.agentmark.co/v1/traces",
    headers={
        "Authorization": f"Bearer {os.environ['AGENTMARK_API_KEY']}",
        "X-Agentmark-App-Id": os.environ["AGENTMARK_APP_ID"],
    },
)
data = response.json()

​

Rate limiting

​

Span and storage limits

• Span limit — maximum number of spans per month (Hobby/Growth tiers)
• Storage cap — maximum storage used (certain plans only)

​

Error responses

{
  "error": {
    "message": "Not authorized"
  }
}

{
  "error": {
    "code": "span_limit_exceeded",
    "message": "Monthly unit limit exceeded. Upgrade your plan for unlimited units.",
    "details": {
      "currentCount": 20000,
      "limit": 20000,
      "upgradeUrl": "https://app.agentmark.co/settings/billing"
    }
  }
}