clickup-common-errors

# ClickUp Common Errors ## Overview Reference for ClickUp API v2 errors. All errors return JSON with `err` (message) and optionally `ECODE` (error code). ## Error Response Format ```json { "err": "Space not found", "ECODE": "ITEM_015" } ``` ## HTTP Status Errors ### 400 Bad Request | Situation | Response | Fix | |-----------|----------|-----| | Missing required field | `{"err": "Task name required"}` | Include `name` in request body | | Invalid field value | `{"err": "Invalid priority"}` | Priority must be 1-4 or null | | Malformed JSON | `{"err": "Unexpected token"}` | Validate JSON before sending | | Invalid custom field value | `{"err": "Invalid value for field"}` | Match value to field type | ### 401 Unauthorized — OAuth Errors | ECODE | Cause | Solution | |-------|-------|----------| | OAUTH_017 | Token malformed or missing | Include `Authorization: <token>` header | | OAUTH_023 | Workspace not authorized for token | User must re-authorize workspace in OAuth flow | | OAUTH_026 | Token revoked by user | Generate new personal token or re-authenticate | | OAUTH_027 | Workspace not authorized | Re-authorize via OAuth, ensuring workspace scope | | OAUTH_029-045 | Various workspace auth failures | Re-run OAuth flow for the specific workspace | ```bash # Diagnose: verify your token works curl -s -w "\nHTTP %{http_code}\n" \ https://api.clickup.com/api/v2/user \ -H "Authorization: $CLICKUP_API_TOKEN" ``` ### 403 Forbidden | Situation | Fix | |-----------|----...