Errors

API errors are RFC 9457 application/problem+json. type links to the code's entry on this page and code is the stable value to match on.

{"type":"https://watchtowerops.net/docs/errors#not_found","title":"Not found","status":404,"code":"not_found"}

not_found

The resource does not exist, or you cannot access it. Watchtower answers 404, not 403, for another tenant's resources.

forbidden

Your role does not allow this action.

unauthorized

The credential is missing, invalid or expired.

method_not_allowed

The route exists but not with this HTTP method.

validation

A field failed validation; errors names each one.

unprocessable

The request is well formed but cannot be applied; detail says why.

conflict

The request conflicts with current state, such as a duplicate name.

would_exceed_cap

This AI request would go over the monthly AI cap.

limit_exceeded

A limit on this resource would be exceeded.

limit_reached

The plan limit for this resource is reached.

query_too_expensive

The query would read more data than allowed; narrow the time range or filters.

legal_hold

The data is under legal hold and cannot be changed or deleted.

version_limit

The resource has reached its maximum number of versions.

rate_limited

Too many requests; wait for Retry-After.

ai_disabled

AI is off for this organization or project, or its monthly cap is 0.

ai_cap_reached

The monthly AI cap is used up.

too_many_investigations

Too many AI investigations are running.

payload_unavailable

The stored payload cannot be returned; detail says why.

payload_too_large

The request body is too large.

quota_exceeded

An ingest or usage quota is used up.

precondition_failed

If-Match did not match the current version; read it again.

precondition_required

This route needs an If-Match header.

ip_not_allowed

The organization's IP allowlist refuses your address.

would_lock_out_self

The change would lock you out, so it was refused.

read_only_key

This key is read-only.

unavailable

A dependency is temporarily unavailable; retry.

unsupported_promql

The query uses a PromQL feature that is not supported.

query_timeout

The query ran past its time limit.

query_cancelled

The query was cancelled.

query_overloaded

Too many queries are running; retry shortly.

internal

Something failed on our side.

sso_required

This organization requires single sign-on.

mfa_required

This organization requires multi-factor authentication.

privacy_change_requires_admin

Changing this privacy setting needs the ManagePrivacy permission.

wrong_region

The project lives on another data plane; use the endpoint in the response.

dataplane_unreachable

The project's data plane did not answer in time.

dataplane_bad_response

The project's data plane sent an invalid response.

dataplane_error

The data plane could not run the request.

key_revoked

The project's customer-managed key was revoked, so this data is crypto-shredded.

key_unavailable

The customer-managed key could not be reached; the data is hidden until it can.

client_too_old

Your wtctl is older than this feature needs (426); detail names the minimum version. Upgrade wtctl and retry.