Error Codes¶

Reference for all error codes returned by the Jobko MCP API.

HTTP Status Codes¶

Code	Meaning	Action
`200`	Success	-
`400`	Bad request	Check your request format
`401`	Invalid API key	Verify or regenerate your key
`402`	Insufficient credits	Add credits at dashboard
`403`	Scope not allowed	API key lacks required scope
`429`	Rate limit exceeded	Wait and retry
`500`	Server error	Contact support

JSON-RPC Error Codes¶

For MCP protocol requests:

Code	Name	Description
`-32700`	Parse error	Invalid JSON
`-32600`	Invalid request	Not valid JSON-RPC
`-32601`	Method not found	Unknown method
`-32602`	Invalid params	Wrong or missing parameters
`-32603`	Internal error	Server error
`-32001`	Authentication required	Missing or invalid API key
`-32002`	Rate limit exceeded	Too many requests
`-32003`	Insufficient credits	Add credits to continue
`-32004`	Scope not allowed	API key lacks permission

Error Response Format¶

REST API¶

{
  "detail": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits for this operation",
    "required_credits": 2,
    "available_credits": 0
  }
}

JSON-RPC (MCP)¶

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32003,
    "message": "Insufficient credits",
    "data": {
      "required_credits": 2,
      "available_credits": 0
    }
  }
}

Common Errors¶

"Authentication required"¶

Cause: Missing or invalid Authorization header.

Solution:

# Make sure to include the header
curl -H "Authorization: Bearer jk_YOUR_KEY" ...

"Invalid API key"¶

Cause: API key doesn't exist or was revoked.

Solution: Generate a new key at jobko.ai/dashboard#agent

"Insufficient credits"¶

Cause: Not enough credits for the requested operation.

Solution: Add credits at jobko.ai/dashboard#credits

"Rate limit exceeded"¶

Cause: Too many requests in a short period.

Solution: Wait and retry. Check the Retry-After header:

Retry-After: 60  # Wait 60 seconds

"Scope not allowed"¶

Cause: Your API key doesn't have permission for this operation.

Solution: Create a new API key with the required scope, or edit your existing key's permissions.

"User profile not found"¶

Cause: The user hasn't set up their profile yet.

Solution: Ask the user to complete their profile at jobko.ai/dashboard#profile