Admin API

Errors

HTTP	extensions.code	Meaning
200	—	Success. Partial errors may be in errors[] (e.g. ACCESS_DENIED on one field).
200	`userErrors`	Mutation input was invalid — check payload.userErrors[{ field, message }].
400	PARSE_ERROR / GRAPHQL_VALIDATION_FAILED	Malformed query or unknown field.
400	MAX_COST_EXCEEDED / MAX_DEPTH_EXCEEDED	Query too expensive or too deep.
401	UNAUTHORIZED	Missing, wrong or revoked token.
404	UNSUPPORTED_VERSION	Unknown API version in the URL.
429	THROTTLED	Rate limited — wait Retry-After seconds.
200	INTERNAL_SERVER_ERROR	Unexpected failure; safe to retry queries.

Mutations never throw for business-rule failures (e.g. fulfilling more than ordered); they return userErrors and a null resource.