Errors and retries
Error responses include an error code and may include a human-readable message.
Analyze endpoint
| Status | error | When |
|---|---|---|
| 400 | bad_request / invalid_request | The JSON body, conversation_id, or speaker value is invalid. |
| 401 | unauthorized | The API key is missing, invalid, or revoked. |
| 403 | forbidden | The issued key is not permitted to call Analyze. |
| 405 | method_not_allowed | The endpoint was called with an unsupported HTTP method. |
| 422 | unprocessable | message is missing, empty, or not a string. |
| 429 | rate_limited | The current request allowance has been reached. |
A 429 rate_limited response may include Retry-After in seconds.
{ "error": "rate_limited" }Integration receiver
| Status | error | When |
|---|---|---|
| 400 | invalid_json / invalid_payload | The signed body is not valid JSON or lacks a usable conversation. |
| 401 | invalid_signature | The request cannot be verified with the receiver signing secret. |
| 404 | not_found | The receiver URL is unknown or disabled. |
| 405 | method_not_allowed | The receiver only accepts POST. |
| 413 | payload_too_large | The request body exceeds the accepted size. |
| 422 | batch_exceeds_limit | The delivery is larger than a fresh workspace limit and must be reduced before retrying. |
| 429 | rate_limited / quota_exceeded | A resettable workspace allowance prevented processing. |
| 500 | processing_failed | Nyeti could not complete processing. The delivery was rolled back before Nyeti returns this response. |
Duplicate deliveries and unsupported events return 200. They are acknowledged without analysis so the source does not retry events that Nyeti intentionally ignores.
A 429 rate_limited response includes Retry-After in seconds. A 422 batch_exceeds_limit response is not resettable: reduce the delivery or change the workspace allowance before trying it again.
Retry policy
For a 429 with Retry-After, wait for that interval before retrying. Retry transient 5xx responses with exponential backoff. Signed integration deliveries are rolled back before Nyeti returns a 500, so retry the same exact body and signature process. Correct other 4xx requests before sending them again.