Quickstart

Create your first agent and execute a task in under 5 minutes.

Prerequisites

• An Acrobi Cortex account (register here)
• curl or any HTTP client

Step 1: Authenticate

export TOKEN=$(curl -s -X POST https://api.cortex.acrobi.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "yourpassword"}' \
  | jq -r '.token')

Step 2: Create an Agent

curl -X POST https://api.cortex.acrobi.com/api/agents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-agent",
    "displayName": "My First Agent",
    "description": "A general-purpose agent for testing",
    "category": "development",
    "model": "claude-sonnet-4-20250514",
    "status": "active",
    "systemPrompt": "You are a helpful development assistant.",
    "capabilities": ["code_review", "documentation"]
  }'

Step 3: Create a Task

curl -X POST https://api.cortex.acrobi.com/api/kanban-tasks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Review the login page",
    "description": "Check the login page for UX issues and suggest improvements",
    "status": "backlog",
    "priority": "medium",
    "assigned_agent": "my-first-agent"
  }'

Step 4: Execute the Agent

curl -X POST https://api.cortex.acrobi.com/api/agents/my-first-agent/execute \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task-id-from-step-3",
    "input": "Review the login page for UX issues"
  }'

Step 5: Check Status

# Get agent status
curl https://api.cortex.acrobi.com/api/agent-status/my-first-agent \
  -H "Authorization: Bearer $TOKEN"

# Get execution details
curl https://api.cortex.acrobi.com/api/agents/my-first-agent/executions \
  -H "Authorization: Bearer $TOKEN"

Next Steps

• API Reference — Full endpoint documentation
• Swarms — Orchestrate multiple agents together
• Webhooks — Get notified when agents complete
• Real-Time — Live agent status via WebSocket
• AI Agent Manifest — For AI agents integrating with Cortex