Kula Job Board API
Public API for job board integrations and career page widgets.
For detailed information on rate limiting, pagination, and error handling, see the API Guides.
Authentication
All requests require Bearer token authentication:
Authorization: Bearer kula_pk_your_token_here
Scopes
Each API key carries a set of scopes. An operation that carries an x-required-scope field names the scope required to call it.
A key missing that scope receives 403 ERR_INSUFFICIENT_SCOPE, which names the scope to add:
{
"error": {
"code": "ERR_INSUFFICIENT_SCOPE",
"message": "This API key is missing the required scope: jobs:read"
}
}
Grant it under Settings → API Management and retry — no new key is needed. Keys created before scopes existed are unrestricted and keep working unchanged.
Base URL
https://api.kula.ai
Rate Limiting
The API sustains 200 requests per minute per API key by default, metered with a leaky-bucket algorithm: a key that has been idle can burst up to 12,000 requests, after which requests are admitted at the sustained rate as the bucket drains. Accounts on a raised limit see proportionally larger figures. Personal access tokens belonging to the same user, including the hosted MCP connector, share one budget.
Every metered response carries X-RateLimit-Limit (your key's burst capacity, in requests), X-RateLimit-Remaining (how much of it is left) and X-RateLimit-Reset (a Unix timestamp for when the bucket would be fully drained). When nothing is left the API responds with 429 Too Many Requests and adds Retry-After, the seconds until one request's allowance returns — which is sooner than X-RateLimit-Reset. Wait for Retry-After before retrying, and add exponential backoff with jitter if the 429s persist. Contact support if your integration needs a higher limit.
Authentication
- HTTP: Bearer Auth
Public API Bearer token
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |