{
  "schemaVersion": "1.0",
  "product": "TopCal",
  "url": "https://topcal.ai/.well-known/errors.json",
  "description": "Structured errors for TopCal marketing URLs when the client sends Accept: application/json. This is not a bookings API.",
  "produces": [
    "application/json"
  ],
  "error": {
    "type": "object",
    "required": [
      "error"
    ],
    "properties": {
      "error": {
        "type": "object",
        "required": [
          "code",
          "status",
          "message",
          "resolution",
          "instance",
          "documentation"
        ]
      }
    }
  },
  "codes": {
    "not_found": {
      "status": 404,
      "message": "No TopCal marketing page at this path.",
      "resolution": "Fetch https://topcal.ai/sitemap.xml, https://topcal.ai/llms.txt, or https://topcal.ai/developers.md. Public booker URLs are /{workspace}/{username}/{eventSlug} on topcal.ai. Host API lives on https://app.topcal.ai."
    },
    "gone": {
      "status": 410,
      "message": "This TopCal URL is gone and will not return.",
      "resolution": "Use https://topcal.ai/llms.txt and https://topcal.ai/sitemap.xml. /30min is not a booker."
    },
    "not_acceptable": {
      "status": 406,
      "message": "This TopCal URL cannot produce the requested media type.",
      "resolution": "Send Accept: text/html, text/markdown, or application/json. Markdown siblings: /index.md, /developers.md, /pricing.md."
    },
    "method_not_allowed": {
      "status": 405,
      "message": "This TopCal marketing route does not accept that HTTP method.",
      "resolution": "Use GET or HEAD. This site has no public bookings API. Host REST is https://app.topcal.ai/api/v1/openapi."
    }
  },
  "recovery": [
    "https://topcal.ai/llms.txt",
    "https://topcal.ai/sitemap.xml",
    "https://topcal.ai/developers.md",
    "https://topcal.ai/.well-known/agent-instructions.md",
    "https://app.topcal.ai/docs",
    "https://app.topcal.ai/api/v1/openapi"
  ]
}