vulns.co
/
GKData.io MCP and API Buy me a coffee

Google

Google API request identity: bind retry semantics to the logical operation

Google's approved request-ID guidance lets each service choose how long it recognizes retries. A duplicate should receive the earlier success response. If reproducing that response is infeasible, the service may return the resource's current state. The supporting AWS article recommends matching both caller and request ID, returning responses with the same meaning, and recording the ID and applying the request's changes as one atomic operation. It also recommends rejecting reuse of an ID with different parameters. These AWS recommendations are separate from Google's requirements.

Open the referenceImplementation GuideReviewed 2026-10-04

How to use this reference

Editorial synthesis: distinguish who may act, which logical operation is being repeated and what state was committed. Document identity scope, retention assumptions and response meaning. A request ID does not confer authority. Preventing duplicate effects does not guarantee eventual success or establish end-to-end exactly-once delivery. Keep each integration's completion and authorization responsibilities explicit.

Before reading

  • Basic familiarity with API requests, distributed failures and application state transitions

Context and limits

  • AIP-155 permits APIs to add request IDs and says they should be optional. The ID belongs to the request, not the resource. Its guarantees apply to the service's documented contract, not every API.
  • The current-state response exception applies when reproducing the historical success response is infeasible. Idempotent effects do not require byte-identical response data.
  • Caller scoping, changed-parameter rejection and coordinated identity/effect recording are AWS guidance, not explicit AIP-155 requirements. AWS describes service-dependent retention; it does not prescribe a universal lifetime.
  • AIP-155's Created and Updated headers both display 2019-05-06. The corresponding first-party commit is timestamped 2024-01-26T17:45:54Z but adds a 2024-01-08 changelog entry. These are distinct maintenance signals, not new 2026 guidance.
  • Authorization separation and completion limits are editorial synthesis. This resource establishes no incident, affected deployment, bounty, implementation correctness, current exposure or testing authorization.

Sources

  1. AIP-155: Request identificationGoogle · reviewed 2026-10-04
  2. Making retries safe with idempotent APIsAmazon Web Services · reviewed 2026-10-04
  3. AIP-155: correct the request message and add a changelog entryGoogle AIP maintainers · reviewed 2026-10-04

Record reviewed 2026-10-04. Snapshot af2809c308fc. Open the complete JSON contract.

Library synced 2026-11-18 · cases last reviewed 2026-10-05

af2809c308fc · JSON exports & schemas · CC BY 4.0 content / MIT software