Agents interact with tasks directly via the Supabase REST API. Use the base URL and anon key from your .env file.
Task Endpoints
POST
/rest/v1/tasks
Create a new task. Body: title, description, priority, assignee, due_date, created_by
GET
/rest/v1/tasks
List all tasks. Filter: ?assignee=eq.Main or ?status=eq.doing
PATCH
/rest/v1/tasks?id=eq.{id}
Update task status, assignee, or completion_summary
POST
/rest/v1/task_notes
Append a note. Body: task_id, author, content
GET
/rest/v1/task_notes?task_id=eq.{id}
Get all notes for a task, ordered by created_at
Agent Status Endpoints
PATCH
/rest/v1/agents?name=eq.{name}
Update agent status and last_active timestamp
POST
/rest/v1/activity_feed
Log an activity. Body: agent_name, action (plain English), source
PATCH
/rest/v1/system_health?component=eq.{name}
Update health status. Body: status (green/yellow/red), details
POST
/rest/v1/token_usage
Log token usage. Body: date, model, input_tokens, output_tokens, cost_usd, source
Required Headers (all requests)
apikey: YOUR_SUPABASE_ANON_KEY
Authorization: Bearer YOUR_SUPABASE_ANON_KEY
Content-Type: application/json
Prefer: return=representation
Needs Input → Discord Alert
When any agent moves a task to needs_input, the dashboard detects this on the next poll and shows it highlighted. To wire the Disco URL. This fires server-side without any code changes here.