api_disabled
HTTP 503
API temporarily unavailable
The requested Comidoc developer surface is disabled.
Resolution: Retry later or check the developer documentation for service updates.
RFC 9457 problem types
Developer API error reference
Every REST and MCP transport error includes a stable code, a dereferenceable type URL, and a request ID. Use the request ID when contacting support.
Too many authentication failures
Too many failed authentication attempts came from this address.
Resolution: Wait for the rate-limit window to reset before trying again.
context_resolution_failed
HTTP 503
API temporarily unavailable
The API request context could not be initialized.
Resolution: Retry shortly. Contact Comidoc if the problem persists.
course_not_found
HTTP 404
Course not found
No active course matches the supplied Udemy course ID or slug.
Resolution: Check the identifier or search the course catalog first.
developer_suspended
HTTP 403
Developer account unavailable
The developer account associated with this request is not active.
Resolution: Open the developer portal or contact Comidoc support.
insufficient_scope
HTTP 403
Insufficient API key scope
The API key does not grant the scope required by this endpoint.
Resolution: Create or rotate a key with the required read scope.
internal_error
HTTP 500
Internal API error
The API could not complete the request because of an internal error.
Resolution: Retry with backoff and provide the request ID if the problem persists.
invalid_api_key
HTTP 401
Invalid API key
The supplied API key is invalid, expired, or revoked.
Resolution: Create or rotate a key in the developer portal.
invalid_content_length
HTTP 400
Invalid Content-Length
The MCP request contains an invalid Content-Length header.
Resolution: Send a valid non-negative Content-Length value or let the HTTP client set it.
invalid_filter_value
HTTP 400
Invalid filter value
A category, language, or level does not belong to the current canonical vocabulary.
Resolution: Use GET /api/v1/filter-options or the MCP get_filter_options tool.
invalid_query
HTTP 400
Invalid query parameters
One or more query parameters do not satisfy the endpoint contract.
Resolution: Correct the reported fields and retry the request.
invalid_rapidapi_proxy
HTTP 401
Invalid RapidAPI request
The RapidAPI proxy identity could not be verified.
Resolution: Send requests through the configured RapidAPI proxy.
invalid_request_body
HTTP 400
Invalid MCP request body
The MCP HTTP request body could not be read or decoded.
Resolution: Send a valid MCP JSON-RPC request body.
mcp_handler_error
HTTP 500
MCP request failed
The MCP server could not complete the protocol request.
Resolution: Retry with backoff and provide the request ID if the problem persists.
mcp_hourly_quota_exceeded
HTTP 429
Anonymous MCP quota exceeded
The anonymous MCP hourly quota has been exhausted.
Resolution: Wait for the reset or authenticate with a Comidoc API key from https://comidoc.com/developers.
MCP transport rate limit exceeded
Too many MCP protocol requests came from this address.
Resolution: Reduce protocol polling and wait for the transport window to reset.
missing_api_key
HTTP 401
API key required
This endpoint requires a Comidoc developer API key.
Resolution: Send Authorization: Bearer cmd_live_… with a key from https://comidoc.com/developers.
monthly_quota_exceeded
HTTP 429
API quota exceeded
The developer account monthly quota has been exhausted.
Resolution: Review usage and plan options at https://comidoc.com/developers.
payload_too_large
HTTP 413
MCP request body too large
The MCP request body exceeds the accepted transport limit.
Resolution: Reduce the request size and retry.
quota_store_unavailable
HTTP 503
Quota service unavailable
Comidoc could not read or update the request quota safely.
Resolution: Retry shortly. The API fails closed while quota state is unavailable.
rate_limit_exceeded
HTTP 429
API quota exceeded
Too many API requests were sent in a short period.
Resolution: Retry after the reported delay and reduce request concurrency.
topic_not_found
HTTP 404
Topic not found
No Comidoc topic matches the supplied slug.
Resolution: Use GET /api/v1/topics or the MCP list_topics tool to discover valid slugs.
unsupported_media_type
HTTP 415
Unsupported media type
The MCP endpoint received an unsupported request content type.
Resolution: Send MCP JSON-RPC requests with Content-Type: application/json.