# Is Cursor giving you a headache?

You were probably searching for a fix for that obscure Cursor error. But maybe you found something better.

Stop debugging. Start coordinating.

Qordinate acts as your intelligent layer between apps like Cursor and your life. We handle the messy API connections and coordination so you can focus on what actually matters.

# Cursor Integration Terminal Errors

## Authentication Errors

### `401 Unauthorized`

```
HTTP 401 Unauthorized
{
  "error": "unauthorized",
  "message": "Invalid API key provided"
}
```

### `403 Forbidden`

```
HTTP 403 Forbidden
{
  "error": "forbidden",
  "message": "API key does not have required permissions"
}
```

## API Errors

### `429 Too Many Requests`

```
HTTP 429 Too Many Requests
{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retry_after": 60
}
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640995200
```

### `400 Bad Request`

```
HTTP 400 Bad Request
{
  "error": "invalid_request",
  "message": "Invalid request parameters",
  "details": {
    "model": "Model not found or not available"
  }
}
```

### `500 Internal Server Error`

```
HTTP 500 Internal Server Error
{
  "error": "internal_error",
  "message": "An internal error occurred"
}
```

## SDK-Specific Errors

### Python SDK: `cursor.APIError`

```python
Traceback (most recent call last):
  File "cursor_script.py", line 10, in <module>
    client = Cursor(api_key='invalid_key')
  File "/usr/local/lib/python3.9/site-packages/cursor/client.py", line 45, in __init__
    client.authenticate()
  File "/usr/local/lib/python3.9/site-packages/cursor/client.py", line 78, in authenticate
    raise APIError('unauthorized', 'Invalid API key provided')
cursor.APIError: unauthorized: Invalid API key provided
```

### Node.js SDK: `CursorAPIError`

```javascript
CursorAPIError: Rate limit exceeded. Please try again later.
    at CursorClient._request (/node_modules/cursor-sdk/dist/client.js:234:19)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async CursorClient.generateCode (/node_modules/cursor-sdk/dist/api.js:123:12)
    at async main (/app/index.js:23:18)
{
  statusCode: 429,
  body: {
    error: 'rate_limit_exceeded',
    message: 'Rate limit exceeded. Please try again later.',
    retry_after: 60
  },
  headers: {
    'x-ratelimit-limit': '100',
    'x-ratelimit-remaining': '0',
    'x-ratelimit-reset': '1640995200'
  }
}
```

## Model-Specific Errors

### `model_not_found`

```
HTTP 400 Bad Request
{
  "error": "model_not_found",
  "message": "The model 'gpt-5-turbo' does not exist or you do not have access to it"
}
```

### `context_length_exceeded`

```
HTTP 400 Bad Request
{
  "error": "context_length_exceeded",
  "message": "The context length exceeds the maximum allowed length for this model"
}
```

### `invalid_prompt`

```
HTTP 400 Bad Request
{
  "error": "invalid_prompt",
  "message": "The prompt contains content that violates our usage policy"
}
```

## Tool Integration Errors

### `tool_execution_failed`

```
HTTP 500 Internal Server Error
{
  "error": "tool_execution_failed",
  "message": "Failed to execute tool: terminal_command",
  "details": "Command not found: nonexistent_command"
}
```

### `file_not_found`

```
HTTP 404 Not Found
{
  "error": "file_not_found",
  "message": "File not found: /path/to/nonexistent/file.txt"
}
```

## Billing Errors

### `insufficient_credits`

```
HTTP 402 Payment Required
{
  "error": "insufficient_credits",
  "message": "Your account has insufficient credits to complete this request"
}
```

### `billing_required`

```
HTTP 402 Payment Required
{
  "error": "billing_required",
  "message": "This feature requires a paid plan"
}
```

## Connection Errors

### `connection_timeout`

```
Error: connect ETIMEDOUT 104.18.10.207:443
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1146:16)
```

### `ssl_error`

```
Error: certificate verify failed: certificate has expired
    at TLSSocket.onConnectSecure (_tls_wrap.js:1504:34)
    at TLSSocket.emit (events.js:314:20)
    at TLSSocket._finishInit (_tls_wrap.js:945:8)
    at TLSWrap.ssl.onhandshakedone (_tls_wrap.js:719:12)
```

## Development Tool Errors

### `invalid_syntax`

```
SyntaxError: invalid syntax
  File "script.py", line 1
    def function(
                ^
SyntaxError: invalid syntax
```

### `import_error`

```
Traceback (most recent call last):
  File "script.py", line 1, in <module>
    import nonexistent_module
ModuleNotFoundError: No module named 'nonexistent_module'
```
