Skip to content
Console
On this page

IDEMPOTENCY_KEY_REUSED

An Idempotency-Key was reused with another body.

An Idempotency-Key was reused with another body.

HTTP 422 · gRPC INVALID_ARGUMENT · the error body

Returned by

MethodScopeWhat it does
access.orgs.createaccess:adminCreates an org. Access assigns the id.
access.orgs.updateaccess:adminUpdates an org.
access.orgs.deleteaccess:adminDeletes an org and everything in it. Deletion cascades through every service, so it returns an Operation.
access.projects.createaccess:adminCreates a project. Access assigns the id.
access.projects.updateaccess:adminUpdates a project.
access.projects.deleteaccess:adminDeletes a project.
access.envs.createaccess:adminCreates an environment. Access assigns the id.
access.envs.updateaccess:adminUpdates an environment.
access.envs.deleteaccess:adminDeletes an environment.
access.service_enablements.updateaccess:adminEnables or disables a service on a project (spec.enabled).
access.api_keys.createaccess:keys:writeCreates an API key. Access assigns the id.
access.api_keys.updateaccess:keys:writeUpdates an API key.
access.api_keys.deleteaccess:keys:writeDeletes an API key.
access.api_keys.revokeaccess:keys:writeRevokes an API key immediately; revocation propagates on its own fast path, ahead of the bulk key data.
access.api_keys.rollaccess:keys:writeRolls an API key: returns a new key with the same spec and revokes the old one after the grace period.
agents.transfers.beginagents:sessionsStages a uniquely identified source epoch on an empty idle Session. The source adapter must already hold its durable one-writer fence.
agents.agents.createagents:writeCreates an agent and its version 1.
agents.agents.updateagents:writeUpdates an agent. A change to spec mints the next AgentVersion; sessions already started keep the version they pinned.
agents.agents.deleteagents:writeDeletes an agent and its versions. An agent with sessions is refused with INVALID_STATE unless force is set, which deletes them too.
agents.agents.runagents:sessionsAtomically admits a pinned task session, initial event and pending turn.
agents.agent_sessions.createagents:sessionsStarts a session of an agent, pinned to its current version unless agent_version names another. Requires a secret key until end-user ownership is implemented. The session starts idle; :send starts its first turn.
agents.agent_sessions.deleteagents:sessionsDeletes a session and its events. A session whose turn is running is refused with INVALID_STATE unless force is set, which interrupts it first.
agents.agent_sessions.archiveagents:sessionsArchives a session: the session and its event log stay readable, but no new turn may start and the session's captured credential handles are revoked. An idle or failed session archives at once; a running turn is refused with INVALID_STATE (interrupt it first). Repeating the call with the same Idempotency-Key returns the same session.
agents.agent_sessions.queue_executionagents:sessionsExplicitly reserves existing captured authority for one future turn, without executing it.
agents.agent_sessions.resumeagents:sessionsConsumes all ready owners atomically with fresh exact-next-turn authority.
agents.agent_sessions.sendagents:sessionsSends a user message. On an idle or failed session it starts a new turn; while a turn runs it is refused with INVALID_STATE (use :steer). The same Idempotency-Key returns the same event.
agents.agent_sessions.steeragents:sessionsSends a message into the running turn; the agent reads it at its next step. On an idle session it is the same as :send.
agents.agent_sessions.interruptagents:sessionsStops the running turn at its current step. Calls already made keep their results; the session becomes idle. A no-op on an idle session.
agents.agent_sessions.decide_approvalagents:sessionsAnswers a tool call waiting for approval; the turn continues.
agents.agent_sessions.submit_tool_resultagents:sessionsReturns the result of a client tool call; the turn continues.
agents.goals.createagents:sessionsCreates an optional objective owned by this Session, without an external Task. The operation_id keeps the original receipt beyond request replay expiry.
agents.goals.settleagents:sessionsSettles only the named Goal/version with an observed environment receipt. Replaying operation_id returns its original receipt, never its successor.
agents.goals.controlagents:sessionsApplies an explicit owner control to this exact Goal/version. Pause interrupts only its current execution; resume does not resolve a wait or clear observed usage. Amend changes only supplied objective/budget fields.
agents.waits.createagents:sessionsCreates a durable wait on an idle Session, with permanent operation replay.
agents.waits.resolveagents:sessionsRecords observed signal evidence or checks a timer against its actual due time.
agents.waits.cancelagents:sessionsCancels only this exact undelivered wait; repeated operations retain receipts.
agents.queued_executions.cancelagents:sessionsCancels only a queued future execution; an already admitted turn retains its receipt.
agents.memory_stores.createagents:writeCreates a memory store.
agents.memory_stores.updateagents:writeUpdates a memory store.
agents.memory_stores.deleteagents:writeDeletes a memory store. A store an agent names is refused with RESOURCE_IN_USE; a store with memories is refused with INVALID_STATE unless force is set, which deletes them too.
agents.memories.createagents:writeWrites a memory.
agents.memories.updateagents:writeChanges a memory's content.
agents.memories.deleteagents:sessionsDeletes a memory. An end user may delete their own.
agents.owner_pools.createagents:adminCreates an owner pool with no members. Its minimums and demotion rules are governance, so the caller needs agents:admin.
agents.owner_pools.updateagents:adminReplaces an owner pool's spec (agents:admin). Members keep their standing; a changed suite or minimum applies from the next :qualify.
agents.owner_pools.deleteagents:adminDeletes an owner pool and its members (agents:admin). Sessions already admitted keep running.
agents.owner_pools.qualifyagents:qualifyRecords an admission suite result for an Agent version. The caller holds agents:qualify and is not the principal whose create or update minted the version (PERMISSION_DENIED). Every minimum met: the member is QUALIFIED. Any score missing or below its minimum: the member is recorded REFUSED with the reason. Each qualification is recorded with its suite, suite version, result and caller; a result already recorded for the member is refused with INVALID_FIELD, so a demoted member returns only with a new suite result. A read-only version is refused with PERMISSION_DENIED; a suite or suite version other than the pool's with INVALID_FIELD. Re-qualifying keeps the member's baseline: the baseline belongs to the version and its pinned model.
agents.owner_pools.observeagents:qualifyRecords a live-metric observation for a member and applies the pool's demotion rules (agents:qualify, refused to the version's authors as in :qualify). The platform computes each rule's baseline: the median of the member's first baseline_observations counted observations of the metric, set only when it is finite and positive. Values of a rule metric are lower-is-better and must not be negative. Once the baseline is set, a metric past baseline * (1 + max_regression) demotes a qualified member. Only :qualify brings a demoted member back.
artifacts.artifacts.createartifacts:writeRegisters an artifact whose bytes were pushed by digest; verification runs after.
artifacts.artifacts.deleteartifacts:writeDeletes an artifact; fails while a Release references it or a legal hold is active.
assets.assets.generateassets:writeRecords the recipes as assets and generates the variants that are missing. Each call is idempotent and works within a bounded time; call again until pending is 0.
assets.assets.approve_variantassets:writeApproves one variant and records who approved it.
assets.assets.reject_variantassets:writeRejects one variant. Its slot is freed and the next :generate fills it; the rejected file keeps serving at its URL.
assets.assets.retire_variantassets:writeRetires one variant. Its URL answers 404 from then on and its slot is freed.
auth.end_users.createauth:writeCreates an end user.
auth.end_users.updateauth:writeUpdates an end user.
auth.end_users.deleteauth:writeDeletes an end user.
auth.end_users.suspendauth:writeSuspends an end user: sessions are revoked and sign-in is refused.
auth.end_users.reactivateauth:writeReactivates a suspended end user.
auth.end_users.unlockauth:writeClears an end user's sign-in lock (repeated failed sign-ins) now.
auth.end_users.revoke_sessionsauth:writeRevokes every session of an end user.
auth.end_users.attach_external_idauth:writeSets the customer's own id for an end user, once: an unset namespace is written, a set one is never rewritten, and a different value for a set namespace is refused. A namespace holds one id for the life of the user. Erasure removes the ids and remembers their hashes, so a value that belonged to an erased user is never handed to another one.
auth.auth_configs.updateauth:writeUpdates an auth config.
auth.sessions.revokeauth:writeRevokes a session.
auth.identities.moveauth:writeMoves a federated or device identity from one end user to another, to fix a wrongly linked player. One transaction: the identity changes owner, the sessions of both end users are revoked, and nothing else about either moves (profile, memberships, data). Refused when it would leave the source with no sign-in, unless the source is suspended, and when the target already has an identity of the same provider. The reason is audited with the operator, both end users and the identity's fingerprint. An operator action: an end user's own session cannot call it.
auth.customer_organizations.createauth:writeCreates a customer organization.
auth.customer_organizations.updateauth:writeUpdates a customer organization.
auth.customer_organizations.deleteauth:writeDeletes a customer organization.
auth.memberships.createauth:writeCreates a membership.
auth.memberships.updateauth:writeUpdates a membership.
auth.memberships.deleteauth:writeDeletes a membership.
auth.organization_roles.createauth:writeCreates an organization role.
auth.organization_roles.updateauth:writeUpdates an organization role.
auth.organization_roles.deleteauth:writeDeletes an organization role.
auth.trusted_issuers.createauth:writeCreates an trusted issuer.
auth.trusted_issuers.updateauth:writeUpdates an trusted issuer.
auth.trusted_issuers.deleteauth:writeDeletes an trusted issuer.
auth.invitations.createauth:writeCreates an invitation.
auth.invitations.revokeauth:writeRevokes a pending invitation.
auth.invitations.acceptauth:writeAccepts a pending invitation for an end user whose verified email is the invited address, and creates the membership.
auth.email_domains.createauth:writeCreates an email domain; the answer names the TXT record to publish.
auth.email_domains.deleteauth:writeDeletes an email domain.
auth.email_domains.verifyauth:writeLooks up the domain's TXT record now; found, the domain is verified.
auth.oauth_clients.createauth:writeCreates an OAuth client.
auth.oauth_clients.updateauth:writeUpdates an OAuth client.
auth.oauth_clients.deleteauth:writeDeletes an OAuth client.
auth.oauth_clients.roll_secretauth:writeIssues a new client secret, returned once; the old one verifies until grace_period ends.
billing.billing_accounts.updatebilling:adminUpdates a billing account: changes plan, spend limit, or billing email.
billing.invoices.record_paymentbilling:payments:recordA seller operator records an externally verified full invoice payment. The platform-only scope cannot be granted by customer owners/admins. The invoice name identifies the customer, not the seller. References are immutable and idempotent per org and method; conflicting reuse is refused.
broker.trust_policies.createbroker:adminCreates a trust policy.
broker.trust_policies.updatebroker:adminUpdates a trust policy.
broker.trust_policies.deletebroker:adminDeletes a trust policy.
broker.trust_policies.open_git_hub_pull_requestbroker:github:pull_requests:createOpens a pull request as the user authorized by the policy's GitHub user Connection. Credentials remain inside Broker. Requires an exact repository, policy subject and actor, and pull_requests=write. Fork heads are refused.
build.builds.createbuild:runCreates a build: one command or one image over a commit or a tree. The Operation is done when the build reaches a final state. run and image are the short forms.
build.builds.cancelbuild:runCancels a queued or running Build; its lease is released and nothing is published.
build.builds.runbuild:runRuns one command over an uploaded tree and settles with its exit code, like the local command. A caller that gets a failure before the command started (BUILD_FAILURE_SETUP_FAILED, NO_CAPACITY) may build locally.
build.builds.build_imagebuild:runBuilds an image, with an SBOM and signed provenance, from a commit or an uploaded tree.
build.build_caches.updatebuild:writeUpdates a build cache.
build.build_caches.deletebuild:writeDeletes a build cache.
build.build_caches.mint_envbuild:runMints the settings a build that runs elsewhere (a laptop, a CI runner) uses to reach the cache: the sccache, Turbo and crates mirror doors and a short-lived token, as environment variables.
build.build_caches.purgebuild:writeEmpties a build cache and keeps the cache. The undo is that the next build refills it.
config.config_flags.createconfig:writeCreates a config flag; the Operation is done when every cell serves it.
config.config_flags.updateconfig:writeUpdates a config flag; the change rolls out in waves and the Operation is done when every cell serves it.
config.config_flags.deleteconfig:writeDeletes a config flag; evaluators then get their compiled-in fallback.
config.config_segments.createconfig:writeCreates a config segment.
config.config_segments.updateconfig:writeUpdates a config segment; every flag naming it follows.
config.config_segments.deleteconfig:writeDeletes a config segment; refused while a flag names it.
connections.connection_providers.createconnections:adminCreates a connection provider, such as an OAuth 2.0 client configuration.
connections.connection_providers.adoptconnections:adminAdopts an existing GitHub App whose non-exportable custody already exists. The server observes public SPKI metadata and verifies signed GET /app before atomically registering the SIGN Key and provider. No private key is accepted.
connections.connection_providers.updateconnections:adminUpdates a connection provider.
connections.connection_providers.deleteconnections:adminDeletes a connection provider; force forgets its local connections only.
connections.connections.begin_authorizationconnections:writeBegins GitHub device authorization for a new or existing user Connection. The operator opens verification_uri and enters user_code once. Broker keeps the device code and all resulting tokens; clients never supply credentials. Reauthorization preserves the Connection's provider and expected login.
connections.connections.complete_authorizationconnections:writePolls one authorization attempt no earlier than next_poll_time. Only an explicit pending response allows another provider poll. Unknown outcomes require a new authorization; successful credentials are sealed and committed before the Connection becomes active. A completed attempt is safe to replay.
connections.connections.import_oauth2_credentialsconnections:writeImports existing OAuth 2.0 credentials into sealed Broker custody for a Connection without returning any secret token.
connections.connections.createconnections:writeRecords an installation; the controller confirms it with the provider.
connections.connections.updateconnections:writeUpdates a connection's metadata.
connections.connections.deleteconnections:writeForgets a connection. The installation itself is removed at the provider.
data.databases.createdata:writeCreates a database. The Operation is done when the controller settles it.
data.databases.updatedata:writeUpdates a database. Fields declared by the current Release's sylphx.toml remain manifest-owned. An overlapping update mask returns HTTP 409 with FAILED_PRECONDITION, the file and key path, and the Release's source commit. Change and release the declaration instead. Undeclared fields remain writable; releasing a manifest without a field restores API writes to that field.
data.databases.deletedata:writeDeletes a database. Fails while spec.deletion_protection is set.
data.databases.rotate_credentialsdata:writeReplaces the database's engine credentials; the old ones stop working once the new ones are served.
data.databases.restoredata:writeRestores the database in place to a point in time inside its retention window; the database is unavailable while it restores.
data.kv_namespaces.createdata:writeCreates a kv namespace. The Operation is done when the controller settles it.
data.kv_namespaces.updatedata:writeUpdates a kv namespace.
data.kv_namespaces.deletedata:writeDeletes a kv namespace. Fails while spec.deletion_protection is set.
data.kv_namespaces.rotate_credentialsdata:writeReplaces the KV namespace's engine credentials; the old ones stop working once the new ones are served.
data.buckets.createdata:writeCreates a bucket. The Operation is done when the controller settles it.
data.buckets.updatedata:writeUpdates a bucket's spec.deletion_protection, spec.cors and spec.lifecycle; every other field is fixed at creation. A mask path replaces the whole field (spec.cors replaces every rule).
data.buckets.deletedata:writeDeletes a bucket. Fails while spec.deletion_protection is set.
data.buckets.rotate_credentialsdata:writeRevokes every S3 key :connect minted for the bucket, at once; connect again for new ones. Keys of other buckets are untouched.
data.search_indexes.createdata:writeCreates a search index. The Operation is done when the controller settles it.
data.search_indexes.updatedata:writeUpdates a search index.
data.search_indexes.deletedata:writeDeletes a search index. Fails while spec.deletion_protection is set.
data.search_indexes.rotate_credentialsdata:writeReplaces the search index's engine credentials; the old ones stop working once the new ones are served.
events.topics.createevents:writeCreates a topic.
events.topics.updateevents:writeUpdates a topic.
events.topics.deleteevents:writeDeletes a topic.
events.events.publish_service_eventevents:publishPublishes a service's own event into a consenting tenant environment. Requires events:publish and the exact events:platform:<service> scope. A webhook_uri selects exactly one registered endpoint in that environment; admission atomically stores its signed, retried delivery, or stores nothing.
events.subscriptions.createevents:writeCreates a subscription.
events.subscriptions.updateevents:writeUpdates a subscription.
events.subscriptions.deleteevents:writeDeletes a subscription.
events.queues.createevents:writeCreates a queue.
events.queues.updateevents:writeUpdates a queue.
events.queues.deleteevents:writeDeletes a queue.
events.queues.replayevents:writeMoves dead-lettered messages, optionally bounded by dead-letter time, back to ready.
events.webhook_endpoints.createevents:writeCreates a webhook endpoint.
events.webhook_endpoints.updateevents:writeUpdates a webhook endpoint.
events.webhook_endpoints.deleteevents:writeDeletes a webhook endpoint.
events.webhook_endpoints.replayevents:writeRedelivers every dead-lettered delivery to the endpoint created in a time range, each as a new attempt.
events.webhook_endpoints.rotate_secretevents:writeReplaces the endpoint's signing secret and returns the new one, once (status.signing_secret). For 24 hours deliveries carry a signature with each secret, so a receiver can switch without dropping one.
events.webhook_endpoints.testevents:writeSends a test event (type sylphx.webhook.test) to the endpoint alone, through the same signing, retries, and delivery log as any other event.
events.webhook_deliveries.replayevents:writeRedelivers one delivery now, as a new attempt.
events.inbound_endpoints.createevents:writeCreates an inbound endpoint.
events.inbound_endpoints.updateevents:writeUpdates an inbound endpoint.
events.inbound_endpoints.deleteevents:writeDeletes an inbound endpoint.
events.realtime_channels.createevents:writeCreates a realtime channel.
events.realtime_channels.updateevents:writeUpdates a realtime channel.
events.realtime_channels.publishevents:publishPublishes one message to the channel: it is appended to the channel's history and pushed to every connected client. A retry with the same Idempotency-Key returns the first message.
events.realtime_channels.deleteevents:writeDeletes a realtime channel.
hosting.services.createhosting:writeCreates a service. The Operation is done when the controller settles it.
hosting.services.updatehosting:writeUpdates a service.
hosting.services.deletehosting:writeDeletes a service.
hosting.service_rollouts.createhosting:writeCreates a rollout.
hosting.service_rollouts.pausehosting:writeHolds a Rollout at its current wave.
hosting.service_rollouts.resumehosting:writeResumes a paused Rollout.
hosting.service_rollouts.aborthosting:writeStops a Rollout; the cells it reached return to the previous Release.
hosting.previews.createhosting:writeCreates a preview. The Operation is done when the controller settles it.
hosting.previews.deletehosting:writeDeletes a preview.
hosting.source_links.createhosting:writeCreates a source link. The Operation is done when the controller settles it.
hosting.source_links.updatehosting:writeUpdates a source link.
hosting.source_links.deletehosting:writeDeletes a source link.
keys.keys.createkeys:writeCreates a key; the signer generates its first version.
keys.keys.updatekeys:writeUpdates a key's rotation period, deletion protection, or metadata.
keys.keys.deletekeys:writeDeletes a key and schedules every version's destruction.
keys.keys.rotatekeys:writeRotates a key: adds a version and makes it primary. Older versions keep verifying and decrypting until destroyed.
keys.key_versions.destroykeys:writeSchedules a key version's destruction after a 24-hour grace; the primary version cannot be destroyed.
knowledge.spaces.createknowledge:writeCreates a space.
knowledge.spaces.updateknowledge:writeUpdates a space.
knowledge.spaces.deleteknowledge:writeDeletes a space. A space that still holds records is refused with INVALID_STATE unless force is set, which deletes its episodes and facts too.
knowledge.knowledge_schemas.createknowledge:writeCreates a knowledge schema.
knowledge.knowledge_schemas.updateknowledge:writeUpdates a knowledge schema. An accepted update publishes a new revision; a change that would invalidate existing records is refused with INVALID_FIELD.
knowledge.knowledge_schemas.deleteknowledge:writeDeletes a knowledge schema. A schema a space still accepts is refused with RESOURCE_IN_USE.
knowledge.episodes.createknowledge:writeRecords an episode and returns at once (remember); extraction reads it afterwards.
knowledge.episodes.deleteknowledge:writeDeletes an episode, the facts that cite only it, and its search and embedding entries; facts that also cite other episodes are re-scored.
knowledge.entities.createknowledge:writeCreates an entity in a space. An entity whose external id already names one in the graph is refused with RESOURCE_ALREADY_EXISTS, which names it; use Update with allow_missing to upsert.
knowledge.entities.updateknowledge:writeUpdates an entity. With allow_missing it is the structured upsert (upsert_entity): an entity matched by external_ids is updated, otherwise one is created.
knowledge.entities.deleteknowledge:writeDeletes an entity and every fact about it. With force it is a data-rights erasure: the episodes the person wrote are deleted too, with their search and embedding entries.
knowledge.entities.mergeknowledge:writeMerges other entities into this one: their facts and external ids resolve to it. The merge is recorded and reversible with :split; it is never a silent rewrite.
knowledge.entities.splitknowledge:writeSplits a merged entity back out of this one, with the facts and external ids it brought.
knowledge.relations.createknowledge:writeRecords a fact in a space (relate). A fact that contradicts a current one with the same subject and a single-valued predicate closes the older fact; nothing is overwritten.
knowledge.relations.deleteknowledge:writeDeletes a fact. Deletion is for data that must go; a fact that stopped being true is closed with :close.
knowledge.relations.closeknowledge:writeCloses a fact (close_fact): it stopped holding in the world at valid_end_time. The fact stays readable for questions about the time before the close.
localization.catalogs.createlocalization:writeCreates a catalog.
localization.catalogs.updatelocalization:writeUpdates a catalog.
localization.catalogs.deletelocalization:writeDeletes a catalog.
localization.catalogs.synclocalization:writeReads the source files and the committed translations into the catalog, then translates what is new or stale. Each call is idempotent and works within a bounded time; call again until pending is 0.
localization.entries.pin_translationlocalization:writeSets the text of one locale as a human override that AI never overwrites. QA runs on the text first; a text with a QA error is rejected with INVALID_FIELD, and the problem lists the findings.
localization.entries.unpin_translationlocalization:writeRemoves the human override of one locale; the next sync may translate it again.
localization.glossaries.createlocalization:writeCreates a glossary.
localization.glossaries.updatelocalization:writeUpdates a glossary.
localization.glossaries.deletelocalization:writeDeletes a glossary.
money.processor_events.retrybilling:processor_events:writeSchedules a held event through the existing idempotent application path. The decision is audited; an etag is required.
money.processor_events.dismissbilling:processor_events:writeDismisses only a held test-mode payout observation, retaining the row and audit. Live, unknown-mode and payment events are refused.
money.merchant_accounts.updatebilling:writeUpdates the merchant account's own settings: the fields named in update_mask.
money.price_catalogs.updatebilling:writeUpdates the environment's catalog: its features and products, whole.
money.checkout_policies.updatebilling:writeUpdates the environment's checkout policy, whole.
money.store_connections.createbilling:writeCreates a store connection; its credential is sealed and never returned.
money.store_connections.updatebilling:writeUpdates a store connection; a new credential replaces the stored one.
money.store_connections.deletebilling:writeDeletes a store connection and its sealed credential.
money.store_purchases.report_usagebilling:writeReports verified delivery and usage facts for an App Store purchase in answer to an observed CONSUMPTION_REQUEST. Strictly fails closed (0 outbound Apple calls) unless Money's append-only buyer-authenticated consent ledger holds an unwithdrawn granted decision for this purchase or app.
money.customer_subscriptions.update_quantitybilling:writeChanges the seat quantity of a web subscription, now, and syncs the processor's subscription item to it. A retry with the same Idempotency-Key (required) and the same request changes nothing twice.
money.customer_subscriptions.change_planbilling:writeMove a web subscription onto another recurring catalog plan.
money.checkout_sessions.createbilling:writeCreates a hosted checkout for a subject.
money.checkout_sessions.expirebilling:writeExpires an open hosted checkout so it can no longer be paid.
money.checkout_sessions.refundbilling:writeRefund all or part of a paid one-time checkout.
money.portal_sessions.createbilling:writeCreates a customer portal session for a subject.
money.licence_keys.generatebilling:licence_keys.approveGenerates a licence key: Money creates the Ed25519 key, seals it, and never returns the private half. Needs the approval-class scope, which the developer role does not hold.
money.licence_keys.importbilling:licence_keys.approveImports an existing Ed25519 key (PKCS8), for a key already pinned in shipped clients. Refused unless the expected public key is the imported key's public half.
money.licence_keys.retirebilling:licence_keys.approveRetires a licence key: it stops signing new terms and stays exported for verification.
money.usage_settings.updatebilling:writeUpdates the usage settings, the enforcement switch included. A change is recorded with who made it.
money.usage_tiers.updatebilling:writeCreates or updates a usage tier.
money.usage_reservations.createbilling:metering:writeReserves usage before the work starts. Refused with PLAN_LIMIT_REACHED (spend limit, no payment method) or INVALID_STATE (suspended) only while enforcement is on; while it is dark the reservation is granted and the refusal is recorded.
money.usage_reservations.settlebilling:metering:writeSettles a reservation with what was used; the unused part returns to headroom. A settle after expiry still records the usage.
money.usage_reservations.releasebilling:metering:writeReleases a reservation that used nothing.
money.usage_events.createbilling:metering:writeRecords usage directly, only for a meter the merchant marked reservation-optional.
money.credit_grants.createbilling:credits.approveGives a subject credit. Append-only: a change is a new grant that supersedes the old. Refused with INVALID_STATE (tax_treatment_unsupported) for post_tax_settlement while the merchant has automatic tax on.
money.usage_invoices.release_collectionbilling:credits.approveReleases a held invoice for collection, audited with who and why. Grant expiry or replacement never does.
money.usage_meters.updatebilling:writeCreates or updates a usage meter. The unit cannot change once it has recorded usage.
money.usage_meter_prices.createbilling:writeAppends a price to a meter's history. It applies from its effective time on and never rewrites usage already rated.
money.revenue_sources.createrevenue:writeRegisters a revenue source. The money source is implicit and never created here.
money.revenue_sources.updaterevenue:writeRenames, pauses or resumes a revenue source, or changes its settings.
money.revenue_sources.deleterevenue:writeDeletes a revenue source and the facts it reported. The money source cannot be deleted; pause it instead.
money.revenue_sources.runrevenue:writeSyncs a revenue source now, or backfills a period. A money source fills any booked fact its environment's ledger holds and the facts lack; a paused source, or one whose connector has not shipped yet, is refused (INVALID_STATE).
network.domains.createnetwork:writeCreates a domain. The Operation is done when the controller settles it.
network.domains.updatenetwork:writeUpdates a domain.
network.domains.deletenetwork:writeDeletes a domain.
network.domains.verifynetwork:writeChecks the verification record now instead of at the next sweep.
network.routes.createnetwork:writeCreates a route. The Operation is done when the controller settles it.
network.routes.updatenetwork:writeUpdates a route.
network.routes.deletenetwork:writeDeletes a route.
network.egress_identities.createnetwork:writeCreates an egress identity. The Operation is done when the controller settles it.
network.egress_identities.updatenetwork:writeUpdates an egress identity.
network.egress_identities.deletenetwork:writeDeletes an egress identity.
network.private_links.createnetwork:writeCreates a private link. The Operation is done when the controller settles it.
network.private_links.updatenetwork:writeUpdates a private link.
network.private_links.deletenetwork:writeDeletes a private link.
notify.phone_numbers.connectnotify:writeConnectPhoneNumber: existing provider-managed lines; execution credentials are transient.
notify.phone_numbers.getnotify:readGetPhoneNumber: existing provider-managed lines; execution credentials are transient.
notify.phone_numbers.listnotify:readListPhoneNumbers: existing provider-managed lines; execution credentials are transient.
notify.phone_numbers.apply_routenotify:writeApplyPhoneNumberRoute: existing provider-managed lines; execution credentials are transient.
notify.phone_numbers.probenotify:writeProbePhoneNumber: existing provider-managed lines; execution credentials are transient.
notify.phone_numbers.read_voicemailnotify:readReadPhoneNumberVoicemail: existing provider-managed lines; execution credentials are transient.
notify.mail_domains.createnotify:writeCreates an email domain.
notify.mail_domains.updatenotify:writeUpdates an email domain.
notify.mail_domains.deletenotify:writeDeletes an email domain.
notify.mail_routes.createnotify:writeCreates a route.
notify.mail_routes.updatenotify:writeUpdates a route.
notify.senders.createnotify:writeCreates a sender.
notify.senders.updatenotify:writeUpdates a sender.
notify.senders.deletenotify:writeDeletes a sender.
notify.recipients.createnotify:writeCreates a recipient.
notify.recipients.updatenotify:writeUpdates a recipient.
notify.recipients.register_push_devicenotify:writeAtomically registers or renews one Web Push subscription. Other devices remain registered. The sender and recipient must share an environment.
notify.recipients.unregister_push_devicenotify:writeUnregisters only the device identified by the registration receipt. A missing registration is already unregistered and succeeds.
notify.recipients.deletenotify:writeDeletes a recipient.
notify.preferences.updatenotify:writeUpdates a preference.
notify.preferences.deletenotify:writeDeletes a preference.
notify.message_topics.updatenotify:writeUpdates a message topic; with allow_missing, creates it.
notify.message_topics.deletenotify:writeDeletes a message topic; its messages are admitted with no gate or topic limit.
notify.suppressions.createnotify:writeCreates a suppression.
notify.suppressions.deletenotify:writeDeletes a suppression.
notify.templates.createnotify:writeCreates a template.
notify.templates.updatenotify:writeUpdates a template.
notify.templates.deletenotify:writeDeletes a template.
notify.messages.createnotify:sendSends a Message.
notify.messages.cancelnotify:sendCancels a Message whose deliveries have not been handed off.
notify.mailboxes.createnotify:writeCreates a mailbox.
notify.mailboxes.updatenotify:writeUpdates a mailbox.
notify.mailboxes.erase_addressnotify:writeRemoves an address's personal data from every inbound email of the mailbox that it sent or that names it, keeping the dedupe keys so a poll never brings the mail back.
notify.mailbox_oauth_apps.createnotify:writeCreates a mailbox OAuth app.
notify.mailbox_oauth_apps.updatenotify:writeUpdates a mailbox OAuth app.
notify.mailbox_connect_links.createnotify:writeMints a mailbox connect link for one end user; the response carries its url, which no later call returns.
notify.inbox_items.mark_readnotify:writeMarks an inbox item read.
notify.inbox_items.mark_unreadnotify:writeMarks an inbox item unread.
notify.inbox_items.archivenotify:writeArchives an inbox item.
notify.broadcasts.createnotify:writeCreates a broadcast.
notify.broadcasts.updatenotify:writeUpdates a broadcast.
notify.broadcasts.deletenotify:writeDeletes a broadcast.
notify.broadcasts.sendnotify:sendSends a Broadcast now.
notify.broadcasts.cancelnotify:sendCancels a Broadcast; messages already admitted still deliver.
notify.sms_numbers.createnotify:writeProvisions one carrier number within explicit cost limits and receives its SMS.
notify.sms_numbers.adoptnotify:writeAdopts an existing active carrier SMS number binding into one environment without purchasing a new number.
notify.support_inboxes.createnotify:support:configureCreates an idempotent SupportInbox; changed replay and illegal state are refused.
notify.support_inboxes.updatenotify:support:configureUpdates configuration with a strong ETag; intake never creates a missing inbox.
notify.support_cases.createnotify:support:operateCreates an idempotent SupportCase; changed replay and illegal state are refused.
notify.support_cases.apply_support_decisionnotify:support:operateAtomically applies a typed decision, tracks and audit after checking expected_version. FINAL_NO_REPLY reopens to ACT_NOW only for an allowed trigger; spam requires a clearing verdict.
notify.support_cases.ingest_support_signalnotify:support:ingestAdmits one authenticated source signal, deduped by immutable identity. Spam signals wake reclassification review without reopening, customer reply or new business action.
notify.support_cases.reveal_support_requesternotify:support:revealReveals the protected case requester under a purpose-bound grant and appends an audited read.
notify.support_cases.importnotify:support:importImports inert history with unchanged source IDs/keys/tombstones, full-record hashes and explicit migration exceptions. It sends nothing, runs no agent and meters no resolution.
notify.support_thread_messages.createnotify:support:operateCreates an idempotent SupportThreadMessage; changed replay and illegal state are refused.
notify.support_actions.createnotify:support:actionsCreates an idempotent SupportAction; changed replay and illegal state are refused.
notify.support_actions.begin_support_action_attemptnotify:support:dispatchClaims one fenced attempt of a conclusively dispatchable action. An expired in-flight claim becomes UNCERTAIN, never PENDING.
notify.support_actions.record_support_action_receiptnotify:support:receiptsRecords an authenticated immutable authority receipt. Transport state changes alone never change a case or business action.
notify.support_actions.reconcilenotify:support:reconcileQueries the original authority/key first; UNKNOWN remains UNCERTAIN. Only a verified NOT_APPLIED query receipt for the current attempt and uncertainty episode permits another attempt of the same action/key.
notify.support_reconciliations.runnotify:support:reconcileRuns one scoped daily census, dense due pass or migration comparison on demand. Incomplete coverage never proves zero exceptions.
observability.uptime_sources.updateobservability:writeConfigures manifest reconciliation; absent subscriptions require an empty etag.
observability.log_entries.writeobservability:ingestIngests a batch of log entries atomically. The same Idempotency-Key and digest replays the same batch; a different digest under the key conflicts.
observability.traces.write_spansobservability:ingestIngests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries.
observability.error_groups.captureobservability:ingestCaptures one error occurrence. It is grouped by fingerprint when the caller sets one, else by exception type and the symbolicated in-app stack; release is never part of the group. A new occurrence reopens a resolved group. Secrets and personal data are scrubbed by the environment's Scrubbing Policy before storage. A fingerprint-equal replay bills no second new-error unit. Under quota pressure the response says what to sample. Browsers call it with a publishable key that holds observability:ingest (CORS allowed, rate-limited per environment).
observability.error_groups.acknowledgeobservability:writeAcknowledges an error group.
observability.error_groups.resolveobservability:writeResolves an error group; a new occurrence reopens it.
observability.error_groups.reopenobservability:writeReopens a resolved or acknowledged error group.
observability.source_maps.createobservability:writeUploads a source map for one release and minified file. Uploading the same release and file again replaces it.
observability.scrubbing_policies.updateobservability:writeUpdates the environment's scrubbing policy.
release.releases.createrelease:writeCreates a release: admits it and rolls it out in waves. The Operation is done when the release is live or halted.
release.releases.deployrelease:writeDeploys through the existing redeploy writer. An explicit commit can start missing native builds and provision declared resources, then refuse with commit_not_fully_built before recording a Release. That response returns no pending operation or build IDs; read progress before resubmitting. Without commit, reuse live members, or the newest recorded commit if no live Release exists. With no prior Release, require an explicit commit. A recorded Release still needs normal admission and post-merge proof. The Operation is done once the Release is recorded; its status.state then follows admission and rollout.
release.releases.rollbackrelease:writeRolls the environment back without a build: a new Release, admitted at once, carrying the exact artifacts and configuration versions of the newest earlier Release that served and differs from the live one, or of release. The database is not rolled back. The Operation is done once the Release is recorded; its status.state then follows the rollout.
runners.scale_sets.createrunners:writeCreates a scale set. The Operation is done when the controller settles it.
runners.scale_sets.updaterunners:writeUpdates a scale set.
runners.scale_sets.deleterunners:writeDeletes a scale set.
sandboxes.pools.createsandboxes:writeCreates a pool. The Operation is done when the controller settles it.
sandboxes.pools.updatesandboxes:writeUpdates a pool.
sandboxes.pools.deletesandboxes:writeDeletes a pool.
sandboxes.leases.createsandboxes:writeCreates a lease: granted now and returned READY (or GRANTED when wait_ready is false), or refused with a typed error. There is no queue.
sandboxes.leases.renewsandboxes:writeExtends expire_time, never past the shape's longest lease. Does not change the generation.
sandboxes.leases.releasesandboxes:writeEnds a lease with END_REASON_RELEASED; the machine is destroyed and never leased again, and attached volumes are detached.
sandboxes.leases.pausesandboxes:writePauses a lease: its disk is kept and its machine destroyed; the generation increases. Process memory is not kept.
sandboxes.leases.resumesandboxes:writeResumes a paused lease on a machine granted now, or refuses it; the generation increases.
sandboxes.leases.set_networksandboxes:writeReplaces a running lease's outbound policy. The generation does not change; the new policy applies before the call returns.
sandboxes.leases.mint_tokensandboxes:execMints a lease token for the data plane, bound to the current generation. Hand it to a process that must not hold the Access key.
sandboxes.leases.execsandboxes:execDispatches one command at most once per lease and execution key. Each HTTP response waits at most 20 seconds: repeat the exact request and key after IDEMPOTENCY_IN_PROGRESS, honoring Retry-After, until the recorded result or a terminal error arrives. Pending observations do not consume the client's transient-error retry budget. Disconnect only stops waiting. Results (capped at 1 MiB per stream) remain replayable after lease expiry. An unknown outcome is never dispatched again. Interactive processes use the guest protocol at status.endpoints.guest_uri.
sandboxes.leases.write_filesandboxes:execWrites one file in the lease, at most 16 MiB, creating parent directories.
sandboxes.leases.remove_filesandboxes:execRemoves one file or directory tree in the lease.
sandboxes.leases.open_portsandboxes:execExposes a guest port.
sandboxes.leases.close_portsandboxes:execStops exposing a guest port.
sandboxes.volumes.createsandboxes:writeCreates a volume.
sandboxes.volumes.updatesandboxes:writeUpdates a volume: grows spec.size_gib and edits metadata.
sandboxes.volumes.deletesandboxes:writeDeletes a volume and destroys its data. Refused RESOURCE_IN_USE while it is attached.
sandboxes.snapshots.createsandboxes:writeCaptures a running lease's disk as a snapshot.
sandboxes.snapshots.deletesandboxes:writeDeletes a snapshot.
secrets.secrets.createsecrets:writeCreates a secret, without a value; add one with CreateSecretVersion.
secrets.secrets.updatesecrets:writeUpdates a secret.
secrets.secrets.deletesecrets:writeDeletes a secret and destroys every version.
secrets.secret_versions.createsecrets:writeAdds a value to a secret as its newest version. The value is never returned.
secrets.secret_versions.disablesecrets:writeDisables a secret version: bindings stop delivering it.
secrets.secret_versions.enablesecrets:writeEnables a disabled secret version.
secrets.secret_versions.destroysecrets:writeDestroys a secret version's value irrecoverably.
secrets.secret_bindings.createsecrets:writeCreates a secret binding.
secrets.secret_bindings.updatesecrets:writeUpdates a secret binding.
secrets.secret_bindings.deletesecrets:writeDeletes a secret binding.
secrets.profiles.createsecrets:writeCreates an empty profile; its first version is written by a write-back mount (:open with WRITE_BACK, then :commit).
secrets.profiles.updatesecrets:writeUpdates a profile's grants or declared paths. Granting a mount is this call: nothing else adds a grant.
secrets.profiles.commitsecrets:mountWrites a mounted profile back as a new version, by compare-and-set on the version the attachment was opened at (or last committed). When another write landed first, nothing is lost: the result is still a new version, merged site by site with the newer write winning, and marked as a conflict.
workflows.workflows.createworkflows:writeCreates a workflow.
workflows.workflows.updateworkflows:writeUpdates a workflow.
workflows.workflows.deleteworkflows:writeDeletes a workflow.
workflows.schedules.createworkflows:writeCreates a schedule.
workflows.schedules.updateworkflows:writeUpdates a schedule; with allow_missing it creates the schedule when it does not exist, so its short name schedule is an upsert by name.
workflows.schedules.deleteworkflows:writeDeletes a schedule.
workflows.schedules.pauseworkflows:writePauses a Schedule: no fire starts a Run until it is resumed.
workflows.schedules.resumeworkflows:writeResumes a paused Schedule; missed fires follow catchup_window.
workflows.runs.createworkflows:runStarts a Run of a Workflow, now or after start_delay or at schedule_time. run_id is the caller's key: the same key and intent return the same Run, a changed intent is refused. An end user's session may call it on a Workflow whose callers is USERS when the session holds the Workflow's permission.
workflows.runs.start_batchworkflows:runStarts a batch: a parent Run that fans out one child Run per item, each with a stable index and count.
workflows.runs.signalworkflows:runSends a named signal to a running Run; a wait op for that name resumes with its payload. A signal to a closed Run fails with INVALID_STATE. An end user's session may call it on a Workflow whose callers is USERS when the session holds the Workflow's permission.
workflows.runs.cancelworkflows:runRequests cancellation. Timers and waits stop; a running invocation is not interrupted: the handler receives one final invocation with cancel: true, and the Run ends cancelled when it answers. An end user's session may call it on a Workflow whose callers is USERS when the session holds the Workflow's permission.
workflows.jobs.createworkflows:writeCreates a job.
workflows.jobs.updateworkflows:writeUpdates a job. Runs already started keep the generation they pinned.
workflows.jobs.deleteworkflows:writeDeletes a job.
workflows.job_runs.createworkflows:runStarts a run of a Job now. The same Idempotency-Key returns the same run for 24h; a Schedule fire uses {job}:{intended time}. With concurrency forbid, a start while a run is active fails with INVALID_STATE.
workflows.job_runs.create_pinnedworkflows:runStarts exactly the pinned Job snapshot under a permanent caller-selected run id. Predecessor servers do not serve this route, so unsupported pins cannot silently start work. Replays return the original immutable run.
workflows.job_runs.cancelworkflows:runCancels a job run: SIGTERM, then SIGKILL after 30s. A closed run fails with INVALID_STATE.
workflows.distributed_jobs.createworkflows:writeCreates a distributed job.
workflows.distributed_jobs.updateworkflows:writeUpdates a distributed job. Runs already started keep the generation they pinned.
workflows.distributed_jobs.deleteworkflows:writeDeletes a distributed job.
workflows.distributed_runs.createworkflows:runStarts a run of a distributed job. The same Idempotency-Key returns the same run for 24h.
workflows.distributed_runs.cancelworkflows:runCancels a distributed run: workers get SIGTERM and 30s, then leases are released; finished shards are kept. A closed run fails with INVALID_STATE.
workflows.distributed_runs.add_shardsworkflows:runAppends shards to a run started with an open manifest; close ends the manifest, and the run ends once those shards are done.