API Documentation

Base URL

1. Register a Publisher Account

curl -X POST BASE_URL/v1/publishers/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Agent",
    "slug": "my-ai-agent"
  }'

# Response:
# {
#   "data": {
#     "publisher": { "id": "...", "name": "My AI Agent", "slug": "my-ai-agent" },
#     "api_key": "atm_xxxxxxxxxxxxx"  ← Save this!
#   }
# }

Python Client

import requests

BASE = "BASE_URL/v1"
API_KEY = "atm_xxxxxxxxxxxxx"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Register
resp = requests.post(f"{BASE}/publishers/register", json={
    "name": "My Agent", "slug": "my-agent"
})
api_key = resp.json()["data"]["api_key"]

Semantic search for tools. No authentication required.

curl

curl -X POST BASE_URL/v1/tools/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "translate text to another language",
    "filters": {
      "categories": ["nlp"],
      "min_quality_score": 0.7
    },
    "page": 1,
    "per_page": 10
  }'

Python

resp = requests.post(f"{BASE}/tools/search", json={
    "query": "translate text to another language",
    "filters": {"categories": ["nlp"], "min_quality_score": 0.7},
    "page": 1,
    "per_page": 10
})
tools = resp.json()["data"]
for tool in tools:
    print(f"{tool['name']} (quality: {tool['quality_score']})")

Response Schema

{
  "data": [
    {
      "id": "uuid",
      "slug": "google-translate",
      "name": "Google Translate",
      "capability_summary": "Translates text between 100+ languages",
      "quality_score": 0.92,
      "tags": ["nlp", "translation"],
      "latest_version": {
        "version": "1.0.0",
        "endpoint_method": "POST",
        "auth_type": "api_key"
      }
    }
  ],
  "pagination": { "page": 1, "per_page": 10, "total": 5, "total_pages": 1 }
}

Invoke any tool through the marketplace proxy. The marketplace adds circuit breaker protection, metrics tracking, and automatic failover.

curl

curl -X POST BASE_URL/v1/invoke/google-translate \
  -H "Authorization: Bearer atm_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "target_lang": "fr"}'

# Response headers include:
# X-Marketplace-Latency-Ms: 234
# X-Marketplace-Tool-Version: 1.0.0
# X-Circuit-Breaker-Status: closed

Python

resp = requests.post(
    f"{BASE}/invoke/google-translate",
    headers=headers,
    json={"text": "Hello world", "target_lang": "fr"}
)
result = resp.json()
print(f"Latency: {resp.headers.get('X-Marketplace-Latency-Ms')}ms")
print(f"Circuit breaker: {resp.headers.get('X-Circuit-Breaker-Status')}")