Skip to content

Errors

Every error is a problem document, with Content-Type: application/problem+json:

Error response
{
"type": "https://developer.seaforms.io/api/errors/#validation_failed",
"title": "Some answers need fixing",
"status": 422,
"code": "validation_failed",
"detail": "2 answers need fixing.",
"errors": {
"email": { "key": "invalid_email" },
"budget": { "key": "required" }
},
"requestId": "req_01JC8H2K4M7P9X3V5B8N1Q6W2T"
}
  • code is what your program should branch on. It’s stable. title and detail are for people, and may change.
  • errors appears on answers that need fixing, keyed by question, each with a message key and its values.
  • issues appears on a draft or live config that won’t go through: the publish checker’s list.
  • requestId is the same as the Seaforms-Request-Id header. Quote it when you ask us about a problem.
StatusCodeWhen
400bad_requestMalformed JSON, a wrong type, or a property the endpoint doesn't know.
401unauthenticatedNo token, or a bad or ended one.
401session_invalidA form's session has ended or isn't valid. @seaforms/react renews it and tries again by itself.
403forbiddenThe key doesn't have the scope, or its maker's role doesn't allow it.
403origin_not_allowedA checkout from an address that isn't on the site's list.
403verification_requiredThis needs a confirmed person, and the form's session isn't one.
403payment_blockedThis session had too many failed payments.
403plan_requiredThe site's plan doesn't include this. Carries requiredPlan.
403workspace_closedThe workspace was deleted. For 7 days an owner can restore it, and the key works again.
404not_foundIt doesn't exist, was deleted, or is in another workspace.
409form_not_openThe form is paused, closed, scheduled or full. Carries status.
409price_changedA checkout's amount differs from what the visitor saw. Carries the new pricing and payment.
409revision_unknownA checkout from a version of the form we never published.
409payments_pausedThe form's payments are paused after a spike of failures.
409conflictThe object's state doesn't allow this right now. detail says why.
412precondition_failedIf-Match is out of date: someone else saved first. Carries current. See Editing safely.
413payload_too_largeOver a size limit.
415unsupported_media_typeA content type this endpoint doesn't take.
422validation_failedAnswers need fixing. Carries errors.
422invalid_documentA draft that won't publish, or a live config with errors. Carries issues.
422coupon_invalidA discount code that isn't valid now. Carries reason.
422idempotency_key_reusedThe same Idempotency-Key with a different body.
428precondition_requiredThis needs If-Match, and it was missing.
429rate_limitedToo many requests. Retry-After says when to try again.
500server_errorOur fault. It's safe to retry.
503unavailableSomething we depend on is down. Retry-After says when to try again.
Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks