Errors

Every Management API error returns the same JSON envelope. The error field is a stable, machine-readable code; docs_url links to the page for that code.

{
  "error": "not_found",
  "message": "Project 'checkout' was not found.",
  "docs_url": "https://featureflip.io/docs/management-api/errors/not_found"
}

See Conventions → Errors for every envelope field.

Error codes

Code	HTTP	Meaning
bad_request	400	Malformed or unprocessable request
validation_failed	400	One or more fields failed validation
unauthorized	401	Missing, invalid, expired, or revoked token
forbidden	403	Token’s role is insufficient
not_found	404	Resource doesn’t exist or isn’t visible
method_not_allowed	405	HTTP method not supported on this path
idempotency_key_in_progress	409	A same-key create is still in flight
unsupported_media_type	415	Content-Type was not application/json
rate_limited	429	Rate limit exceeded
internal_error	500	Unexpected server error