Error reference

When Ecco refuses a request from your AI assistant, it returns a short error with a code. Your assistant usually explains it for you. Find the code below to see what happened and what to do.

​

What an error contains

​

Connection and access

​

unauthenticated

HTTP 401 · Not retryable The token is missing, mistyped, expired, or revoked. Check its status in Configuration → AI integrations. If it is expired or revoked, create a new token and set it up again, as described in AI integrations.

​

insufficient_scope

HTTP 403 · Not retryable The token does not include the permission this request needs, for example guest conversation text. Create a new token with the right options, or ask an owner or admin of the property.

​

forbidden

HTTP 403 · Not retryable Your account cannot see this item. Use an account with access to it, or ask an owner or admin to update your role.

​

property_scope_required

HTTP 403 · Not retryable This request needs access to every property of the hotel, and your account sees only some of them. Use an account with access to all properties.

​

not_found

HTTP 404 · Not retryable The item does not exist, or your account cannot see it. Ask the assistant to list the items again and pick one from the list. If this happens on every request, write to [email protected].

​

NOT_ENTITLED

HTTP 403 · Not retryable This feature is not part of your hotel’s Ecco setup. Write to [email protected].

​

rate_limited

HTTP 429 · Retryable Too many requests in the last minute for this token or property. Wait the number of seconds shown in Retry-After, then ask again. Asking for several things in one question helps.

​

Requests

​

invalid_input

HTTP 400 · Not retryable The request is not in the expected format, for example an invalid date. Rephrase the question with a clear date or period.

​

result_too_large

HTTP 400 · Not retryable The answer would be too long to return at once. Ask for a shorter period, a single property, or a single day.

​

human_confirmation_required

HTTP 403 · Not retryable This action changes something in Ecco and must be confirmed by a person. Open the link the assistant shows and complete the action in the Ecco dashboard.

​

agent_not_configured

HTTP 409 · Not retryable The Ecco agent is not set up yet for this hotel or channel. Complete the setup in the Ecco dashboard, then ask again.

​

Service

​

upstream_unavailable

HTTP 503 · Retryable A system Ecco reads from, such as your PMS, did not answer in time. Try again in a minute.

​

internal_error

HTTP 500 · Retryable Something unexpected happened on Ecco’s side. Try again later. If it keeps happening, write to [email protected] with the request ID.

​

Dashboard actions

These codes come from actions on arrivals, cleaning, and escalations. They usually mean the item has already changed: read it again before acting.

​

LATE_ARRIVAL_ALREADY_CONFIRMED

HTTP 409 · Not retryable The late arrival is already confirmed. Nothing else to do.

​

LATE_ARRIVAL_NOT_PENDING

HTTP 409 · Not retryable There is no late arrival to confirm: none is expected between 22:00 and 06:00, the guest has already arrived, or the night is over. Check today’s list again.

​

CHECKIN_EXCEPTION_NOT_PENDING

HTTP 409 · Not retryable The booking has no open check-in issue that day: online check-in is complete or unknown, the guest has arrived, or it is another day. Check today’s list again.

​

CLEANING_TASK_ALREADY_DONE

HTTP 409 · Not retryable The cleaning task is already done. Nothing else to do.

​

WORK_ITEM_NOT_FOUND

HTTP 404 · Not retryable The escalation was not found. List the escalations again and pick one from the list.

​

WORK_ITEM_ALREADY_CLOSED

HTTP 409 · Not retryable The escalation is already closed. Nothing else to do.

​

WORK_ITEM_ALREADY_OPEN

HTTP 409 · Not retryable The escalation is already open. Nothing else to do.

​

WORK_ITEM_VERSION_CONFLICT

HTTP 409 · Retryable Someone changed the escalation after it was read. Read it again, then repeat the action.

​

WORK_ITEM_REQUEST_KEY_REUSED

HTTP 409 · Not retryable The same request was already used for a different action. Read the escalation again and repeat the action as a new request.

​

WORK_ITEMS_DISABLED

HTTP 409 · Not retryable Escalations are not available for this account. Write to [email protected].

​

ACTOR_FORBIDDEN

HTTP 403 · Not retryable Your account cannot act on this escalation. Use an account with access to the escalation’s property.