Skip to content
TapLogic API
Italiano

Errors

Every error uses a consistent HTTP status and a body with the same shape. Branch on the code field: it is stable and does not change across versions.

Error shape

HTTP/1.1 400 Bad Request
Request-Id: req_Qm3Xc81ZpRt0aBcYvWsK

{
  "error": {
    "code": "invalid_request",
    "message": "La richiesta non è valida.",
    "doc_url": "https://docs.taplogic.it/it/errors#invalid_request",
    "param": "from",
    "details": [
      { "param": "from", "message": "from deve precedere to." }
    ],
    "request_id": "req_Qm3Xc81ZpRt0aBcYvWsK"
  }
}
codeStable code, in English, safe to use in code.
messageHuman-readable text in Italian or English, from Accept-Language. It can change: do not compare it.
doc_urlThis page, at the code's anchor.
paramThe field or header that caused the error, when there is one.
detailsFor invalid_request: one item per invalid field.
request_idRequest identifier, equal to the Request-Id header. Quote it to support.

Message language

Send Accept-Language: en for English messages. Without it, messages are in Italian.

When to retry

Retry only 429 (after Retry-After) and 5xx (with growing waits). Retried writes must carry the same Idempotency-Key. Other 4xx do not change when repeated.

Every code

CodeHTTPMeaning
authentication_required401No API key provided. Send it in the Authorization header: Bearer tl_live_….
invalid_api_key401The API key is invalid, expired or revoked.
insufficient_scope403The API key does not have the scope this operation requires.
test_mode_unsupported403This operation is not available with a test key. Use a tl_live_ key.
resource_missing404The resource does not exist.
route_not_found404This path does not exist in the API.
invalid_request400The request is invalid.
invalid_json400The request body is not valid JSON.
invalid_cursor400The pagination cursor is invalid.
invalid_api_version400The version in TapLogic-Version does not exist.
payload_too_large413The request body is too large.
idempotency_key_mismatch422This Idempotency-Key was already used with a different request.
idempotency_in_progress409A request with this Idempotency-Key is still in progress.
idempotency_replay_unavailable409The saved response for this Idempotency-Key can no longer be read. Check the state of the resource and use a new key.
rate_limit_exceeded429Too many requests. Wait for the time in Retry-After.
member_is_owner409The company owner cannot be removed.
already_member409This person is already a member of the company.
invitation_pending409A pending invitation already exists for this address.
seats_exhausted409No seats are available. Free a seat or buy more.
tag_deactivated409The tag is deactivated and cannot be changed.
webhook_url_not_allowed400The webhook URL must be https and public.
webhook_limit_reached409You reached the maximum number of webhook endpoints.
webhook_disabled409The endpoint is disabled. Enable it before sending a test event.
internal_error500Internal error. Retry: writes with an Idempotency-Key are safe.