ATOM Documentation

# Get token from login response
export TOKEN="your_jwt_token_here"

# Include in requests
curl -H "Authorization: Bearer $TOKEN" \
  https://[your-tenant].atomagentos.com/api/v1/agents

# Use API key for service accounts
export API_KEY="your_api_key_here"

curl -H "X-API-Key: $API_KEY" \
  https://api.atom.io/api/agents

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 450
X-RateLimit-Reset: 1707225600

{
  "success": true,
  "data": { ... },
  "meta": {
    "timestamp": "2025-02-06T10:00:00Z",
    "request_id": "req_abc123"
  }
}

{
  "success": false,
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "Agent with ID 'xxx' not found",
    "details": { ... }
  },
  "meta": {
    "timestamp": "2025-02-06T10:00:00Z",
    "request_id": "req_abc123"
  }
}

GET /api/agents?page=1&limit=20

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}

GET /api/agents?maturity_level=student&status=active

GET /api/agents?sort=created_at&order=desc

GET /api/agents?q=assistant

npm install @atom/sdk

import { AtomClient } from '@atom/sdk';

const client = new AtomClient({
  apiKey: process.env.ATOM_API_KEY
});

const agents = await client.agents.list();
const agent = await client.agents.create({
  name: 'My Agent',
  role: 'general-assistant'
});

pip install atom-python-sdk

from atom import AtomClient

client = AtomClient(api_key="your_api_key")

agents = client.agents.list()
agent = client.agents.create(
    name="My Agent",
    role="general-assistant"
)

POST /api/webhooks

{
  "url": "https://your-app.com/webhooks/atom",
  "events": ["agent.executed", "agent.graduated"],
  "secret": "webhook_secret"
}

{
  "event": "agent.executed",
  "data": {
    "agent_id": "agent_123",
    "execution_id": "exec_456",
    "status": "success",
    "result": { ... }
  },
  "timestamp": "2025-02-06T10:00:00Z"
}

{
  "event": "agent.graduated",
  "data": {
    "agent_id": "agent_123",
    "previous_level": "intern",
    "new_level": "supervised",
    "readiness_score": 0.85
  },
  "timestamp": "2025-02-06T10:00:00Z"
}