Skip to main content
Version: v1

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​

Public API Bearer token

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT