Errors & billing

Error shape

{
  "error": {
    "code": "INSUFFICIENT_WALLET",
    "message": "…"
  }
}

Code	HTTP	Meaning
`VALIDATION_ERROR`	400	Invalid body/query invalid
`UNAUTHORIZED`	401	Auth missing/invalid
`FORBIDDEN`	403	Read-only key
`NOT_FOUND`	404	Resource missing
`NOT_PUBLISHED` / `NOT_DELETABLE`	409	Wrong lifecycle state
`INSUFFICIENT_WALLET`	402	Onepostly wallet empty
`UNSUPPORTED_PLATFORM`	400	Action not implemented for platform

X actions debit your prepaid Onepostly wallet at X list prices (pass-through, no markup). See X API pricing for current rates.

Thread publish and remote-delete scale with segment count (same categories as on X’s price list).

Top up: Dashboard → Settings → Billing.