Errors
What each error code means and what to do about it.
Errors come back as { "message": "...", "code": "..." }. The message is written for people and can change; match on code.
| Status | Code | Meaning |
|---|---|---|
| 401 | API_KEY_REQUIRED | No server key, or it does not start with dsk_live_ or dsk_test_. |
| 401 | BAD_API_KEY | The key is wrong or was revoked. |
| 404 | WORKSPACE_NOT_FOUND | The key's workspace was deleted. |
| 400 | EXTERNAL_ID_REQUIRED | A contact needs external_id. |
| 400 | CONTACT_REQUIRED | Starting a conversation needs contact.external_id. |
| 400 | BAD_STATUS, BAD_PRIORITY, BAD_TYPE, BAD_KIND | A value is not one of the allowed ones listed on the API page. |
| 404 | TICKET_NOT_FOUND, FEEDBACK_NOT_FOUND, CONVERSATION_NOT_FOUND | The id does not exist in this workspace. |
| 400 | BAD_URL | A webhook URL is not a full https address, or points at a private network. |
| 400 | BAD_EVENTS | A webhook needs at least one event. |
| 429 | TOO_MANY_REQUESTS | Slow down. The server API allows 600 requests a minute per key; the widget has its own lower limits per visitor. |
Widget errors
The widget never throws into your page. If the key is wrong or your site is not on the allowed list, the launcher does not appear and the browser console shows one line starting with Corpland Desk could not start: that says why.