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

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

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'