Developer resource

Deck API errors

Deck API errors are structured JSON. Agents should not parse HTML error pages.

{
  "errors": [{
    "type": "request",
    "code": "api_key_invalid",
    "message": "The API key is not valid.",
    "resolution": "Create a key in https://console.deck.co and send Authorization: Bearer <key>."
  }],
  "request_id": "req_..."
}

• Schema: https://deck.co/errors.json
• Docs: Deck error handling
• Website 404s: /404.json (RFC 9457 problem+json plus the same errors array)
• Public status: /api/status

Use type + code for control flow. Use resolution (or resolutionHints) to recover.

All Deck developer resources · Deck.co home