API Reference

All API requests are made to:

https://delegate.ws/api

The Delegate API uses session-based authentication. To make authenticated requests from your own code, pass your session token as a cookie or use the Authorization header with a bearer token.

curl https://delegate.ws/api/tasks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

All responses are JSON. Successful responses use HTTP 200, 201, or 204. Errors return a JSON object with a message field:

{
  "message": "Unauthorized",
  "status": 401
}

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1710000000

• Workspaces — list and manage workspaces
• Tasks — CRUD for tasks and subtasks
• Meetings — create, update, and query meetings
• GET /api/dashboard/stats — workspace-level stats
• GET /api/mail — paginated email list
• GET /api/knowledge — knowledge base entries
• GET /api/ai/suggestions — pending AI suggestions

Register a webhook URL in Settings → Developer → Webhooks to receive real-time event notifications. Supported events:

• task.created
• task.updated
• task.deleted
• meeting.created
• meeting.completed
• ai.suggestion.created

Webhook payloads are signed with HMAC-SHA256. Validate the X-Delegate-Signature header to verify authenticity.