Authentication

All Hakona API requests must be authenticated using an API key.

Getting an API key

1. Go to Settings → API Keys in the dashboard.
2. Click New API Key, give it a name, and choose a permission scope.
3. Copy the key — it will only be shown once.

Making authenticated requests

Include your API key as a Bearer token in the Authorization header:

curl https://api.hakonalabs.com/v1/workflows \
  -H "Authorization: Bearer hkn_live_xxxxxxxxxxxxxxxxxxxx"

API key scopes

Scope	Access
read	Read workflows, runs, and integrations
write	Create and update workflows
execute	Trigger manual runs
admin	Full access including API key management

Base URL

https://api.hakonalabs.com/v1

Response format

All responses are JSON. Successful responses use HTTP 2xx status codes. Errors use 4xx or 5xx and include an error object:

{
  "error": {
    "code": "workflow_not_found",
    "message": "No workflow found with ID wf_abc123"
  }
}

Rate limits

Plan	Requests per minute
Free	60
Pro	600
Enterprise	Custom

Rate limit headers are included in every response:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1714384800