Skip to main content

Errors, idempotency, and quota

Intro

Intro

Public errors use snake_case codes such as authentication_failed, forbidden, not_found, and validation_failed. Responses never return raw database rows. retrieveParticipation is a read of participation_ref: idempotency none, CAS none, cursor none. The public operation_id stays retrieveParticipation. See the changelog and reference.

Idempotency

Creates send Idempotency-Key. Existing-resource mutations also send If-Match when the binding declares CAS. Replay with the same key and body returns the same result. A different body with the same key fails. Quota is declared per operation; undeclared quota on a read is none.