Skip to content

Errors

Known error shapes surfaced by the portal and backend.

Generic failure

When the backend is unreachable or returns an unexpected body, the portal shows a generic try-again message.

Project create — too_many

You have reached the maximum of 5 projects for your account. Contact support if you need more.

Project create — invalid_url

The portal rejects non-public HTTPS for apiUrl and resultUrl before calling Contabo (error type invalid_url). Contabo production /sdk/project/add may also reject unsafe hosts as unsafe_url.

Secret reveal

  • Missing or expired verification cookie — Please verify yourself to see the project secret.
  • invalid_key / incorrect_key — re-authenticate and try again.

Pay

  • invalid_body — amount must be a positive decimal string accepted by the API.
  • self_transfer — payer cannot be the project owner.
  • insufficient_funds / transfer_limit — payer balance or limits blocked the transfer.

Auth

Login and PIN mutations return state: "error" with a human-readable error.message. PIN logout state clears the challenge and returns to login.

Auth — invalid_credentials

Returned for both unknown user and wrong password (anti-enumeration). Message: “Invalid username or password.”

Auth — rate_limited

Too many login / PIN / secret-key attempts from the same IP+subject. Wait about 15 minutes, then try again.