On this page
INVALID_STATE
The Resource is in a state that forbids the call.
The Resource is in a state that forbids the call.
HTTP 400 · gRPC FAILED_PRECONDITION · the error body
Returned by
| Method | Scope | What it does |
|---|---|---|
access.orgs.delete | access:admin | Deletes an org and everything in it. Deletion cascades through every service, so it returns an Operation. |
access.projects.delete | access:admin | Deletes a project. |
access.envs.delete | access:admin | Deletes an environment. |
access.api_keys.delete | access:keys:write | Deletes an API key. |
access.api_keys.revoke | access:keys:write | Revokes an API key immediately; revocation propagates on its own fast path, ahead of the bulk key data. |
access.api_keys.roll | access:keys:write | Rolls an API key: returns a new key with the same spec and revokes the old one after the grace period. |
agents.transfers.begin | agents:sessions | Stages a uniquely identified source epoch on an empty idle Session. The source adapter must already hold its durable one-writer fence. |
agents.transfers.write_part | agents:sessions | Stores at most 256 KiB of exact bytes under its declared part digest. An acknowledgement loss can repeat the identical part without mutation. |
agents.transfers.finalize | agents:sessions | Re-reads ordered parts, checks the whole snapshot and validates the portable state. An unknown effect stays held; this call never executes. |
agents.transfers.adopt | agents:sessions | After the source durably records the exact verified receipt under its writer fence, atomically projects conserved state without starting a turn. Unknown outcomes or incompatible pinned model context remain held. |
agents.transfers.abort | agents:sessions | Releases only a destination that has not adopted source state. Immutable source bytes/epoch remain retained; source writer release is app-owned. |
agents.agents.delete | agents:write | Deletes an agent and its versions. An agent with sessions is refused with INVALID_STATE unless force is set, which deletes them too. |
agents.agents.run | agents:sessions | Atomically admits a pinned task session, initial event and pending turn. |
agents.agent_sessions.delete | agents:sessions | Deletes 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.archive | agents:sessions | Archives 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_execution | agents:sessions | Explicitly reserves existing captured authority for one future turn, without executing it. |
agents.agent_sessions.resume | agents:sessions | Consumes all ready owners atomically with fresh exact-next-turn authority. |
agents.agent_sessions.send | agents:sessions | Sends 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.steer | agents:sessions | Sends 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.interrupt | agents:sessions | Stops 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_approval | agents:sessions | Answers a tool call waiting for approval; the turn continues. |
agents.agent_sessions.submit_tool_result | agents:sessions | Returns the result of a client tool call; the turn continues. |
agents.goals.create | agents:sessions | Creates an optional objective owned by this Session, without an external Task. The operation_id keeps the original receipt beyond request replay expiry. |
agents.goals.settle | agents:sessions | Settles only the named Goal/version with an observed environment receipt. Replaying operation_id returns its original receipt, never its successor. |
agents.goals.control | agents:sessions | Applies 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.create | agents:sessions | Creates a durable wait on an idle Session, with permanent operation replay. |
agents.waits.resolve | agents:sessions | Records observed signal evidence or checks a timer against its actual due time. |
agents.waits.cancel | agents:sessions | Cancels only this exact undelivered wait; repeated operations retain receipts. |
agents.queued_executions.cancel | agents:sessions | Cancels only a queued future execution; an already admitted turn retains its receipt. |
agents.memory_stores.delete | agents:write | Deletes 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.delete | agents:sessions | Deletes a memory. An end user may delete their own. |
artifacts.artifacts.delete | artifacts:write | Deletes an artifact; fails while a Release references it or a legal hold is active. |
assets.assets.retire_variant | assets:write | Retires one variant. Its URL answers 404 from then on and its slot is freed. |
auth.end_users.import | auth:write | Atomically admits an immutable bounded principal import batch. |
auth.end_users.list_import_records | auth:read | Returns an admitted import batch in canonical source_id order, including sensitive verifier input. |
auth.end_users.suspend | auth:write | Suspends an end user: sessions are revoked and sign-in is refused. |
auth.end_users.reactivate | auth:write | Reactivates a suspended end user. |
auth.end_users.unlock | auth:write | Clears an end user's sign-in lock (repeated failed sign-ins) now. |
auth.end_users.revoke_sessions | auth:write | Revokes every session of an end user. |
auth.end_users.attach_external_id | auth:write | Sets 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.sessions.revoke | auth:write | Revokes a session. |
auth.identities.move | auth:write | Moves 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.invitations.create | auth:write | Creates an invitation. |
auth.invitations.revoke | auth:write | Revokes a pending invitation. |
auth.invitations.accept | auth:write | Accepts a pending invitation for an end user whose verified email is the invited address, and creates the membership. |
auth.email_domains.create | auth:write | Creates an email domain; the answer names the TXT record to publish. |
auth.email_domains.verify | auth:write | Looks up the domain's TXT record now; found, the domain is verified. |
auth.oauth_clients.roll_secret | auth:write | Issues a new client secret, returned once; the old one verifies until grace_period ends. |
broker.trust_policies.delete | broker:admin | Deletes a trust policy. |
broker.trust_policies.exchange_token | broker:exchange | Exchanges the caller's Access grant for a short-lived provider credential under a trust policy (RFC 8693 token exchange): a GitHub App installation token for exactly one of the policy's repositories, narrowed to the requested permissions. The grant's principal (for a delegated grant, its accountable principal) must be a policy subject, its actor must match the policy's actors, and it must hold broker:exchange on this policy. Every call writes one TokenExchange record. A permission the Connection lacks is PERMISSION_DENIED with reason CapabilityMissing, never an outage. |
broker.trust_policies.exchange_read_token | broker:exchange:read | Exchanges the caller's Access grant for a read-only GitHub App installation token. Requires the explicit broker:exchange:read scope on this policy, with the same subject, actor, Connection and repository checks as ExchangeToken. Every resolved permission must be read-only: omitting permissions inherits the policy and is refused if it has writes. The provider's returned permissions must confirm the requested ceiling. Writes one TokenExchange audit record; broker:read cannot issue tokens. |
broker.trust_policies.open_git_hub_pull_request | broker:github:pull_requests:create | Opens 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. |
broker.connections.sign_vapid_assertion | broker:exchange | Signs an RFC 8292 assertion using a committed same-org Web Push Connection. The stored contact supplies the subject; an ordinary caller must hold broker:exchange on this exact Connection and satisfy its TrustPolicy. |
build.builds.cancel | build:run | Cancels a queued or running Build; its lease is released and nothing is published. |
build.build_caches.delete | build:write | Deletes a build cache. |
config.config_flags.delete | config:write | Deletes a config flag; evaluators then get their compiled-in fallback. |
config.config_segments.delete | config:write | Deletes a config segment; refused while a flag names it. |
connections.connection_providers.begin_registration | connections:admin | Begins an expiring, one-use GitHub manifest registration ceremony. Open registration_url to POST the bound, prefilled manifest to GitHub. github_organization selects organization ownership. The state-authorized callback is GET /v1/connections/github-manifest:callback?state=...&code=... and returns only provider metadata and an installation URL. |
connections.connection_providers.begin_oauth2_authorization | connections:write | Begins an expiring hosted OAuth 2.0 authorization ceremony for an OAuth 2.0 ConnectionProvider. Returns an authorization_url carrying an expiring one-use state token handled by GET /v1/connections/oauth2:callback. |
connections.connection_providers.adopt | connections:admin | Adopts 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.delete | connections:admin | Deletes a connection provider; force forgets its local connections only. |
connections.connections.begin_authorization | connections:write | Begins 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_authorization | connections:write | Polls 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_credentials | connections:write | Imports existing OAuth 2.0 credentials into sealed Broker custody for a Connection without returning any secret token. |
connections.connections.delete | connections:write | Forgets a connection. The installation itself is removed at the provider. |
data.databases.delete | data:write | Deletes a database. Fails while spec.deletion_protection is set. |
data.databases.connect | data:write | Returns how to connect to the database: its endpoint and its own engine credentials. The credentials are not API keys and are returned only here. |
data.databases.rotate_credentials | data:write | Replaces the database's engine credentials; the old ones stop working once the new ones are served. |
data.databases.restore | data:write | Restores the database in place to a point in time inside its retention window; the database is unavailable while it restores. |
data.kv_namespaces.delete | data:write | Deletes a kv namespace. Fails while spec.deletion_protection is set. |
data.kv_namespaces.connect | data:write | Returns how to connect to the KV namespace: its endpoint and its own engine credentials. The credentials are not API keys and are returned only here. |
data.kv_namespaces.rotate_credentials | data:write | Replaces the KV namespace's engine credentials; the old ones stop working once the new ones are served. |
data.buckets.delete | data:write | Deletes a bucket. Fails while spec.deletion_protection is set. |
data.buckets.connect | data:write | Returns where to reach the bucket: the Data API address, and, once the bucket is served over S3, an S3 endpoint with keys scoped to this one bucket (s3). It carries no username or password; each call mints new S3 keys, and a client signs with those. |
data.buckets.rotate_credentials | data:write | Revokes every S3 key :connect minted for the bucket, at once; connect again for new ones. Keys of other buckets are untouched. |
data.search_indexes.delete | data:write | Deletes a search index. Fails while spec.deletion_protection is set. |
data.search_indexes.connect | data:write | Returns how to connect to the search index: its endpoint and its own engine credentials. The credentials are not API keys and are returned only here. |
data.search_indexes.rotate_credentials | data:write | Replaces the search index's engine credentials; the old ones stop working once the new ones are served. |
events.queues.replay | events:write | Moves dead-lettered messages, optionally bounded by dead-letter time, back to ready. |
events.webhook_endpoints.replay | events:write | Redelivers every dead-lettered delivery to the endpoint created in a time range, each as a new attempt. |
events.webhook_endpoints.test | events:write | Sends 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.replay | events:write | Redelivers one delivery now, as a new attempt. |
events.realtime_channels.join | events:write | Joins a persistent Chat conversation. |
events.realtime_channels.leave | events:write | Leaves Chat while retaining durable read state. |
events.realtime_messages.react | events:write | Adds or removes a member reaction on a visible Chat message. |
events.realtime_members.read | events:write | Advances a member read cursor monotonically and sets mute. |
events.chat_profiles.get | events:read | Gets a Chat profile and fresh presence. |
events.chat_profiles.configure | events:write | Configures an authenticated Chat identity through its trusted backend. |
events.chat_profiles.set_relationship | events:write | Changes friendship or a bilateral interaction block. |
events.chat_profiles.list_relationships | events:read | Lists friends and pending requests with presence. |
events.chat_profiles.report | events:write | Reports a message, image or user to the moderation queue. |
events.chat_profiles.review_media | events:write | Registers an image and its automated moderation receipt. |
events.chat_profiles.bind_identity | events:chat:admin | Records an exact Auth-verified guest-to-platform identity link grant. |
events.chat_profiles.merge_identity | events:chat:admin | Rehomes linked guest state without discarding messages or relationships. |
events.chat_profiles.register_push_device | events:write | Registers a browser device using only the authenticated Chat session. |
events.chat_reports.list | events:read | Lists the moderation queue. |
events.chat_reports.resolve | events:write | Records a moderation response. |
hosting.services.delete | hosting:write | Deletes a service. |
hosting.service_rollouts.pause | hosting:write | Holds a Rollout at its current wave. |
hosting.service_rollouts.resume | hosting:write | Resumes a paused Rollout. |
hosting.service_rollouts.abort | hosting:write | Stops a Rollout; the cells it reached return to the previous Release. |
hosting.previews.delete | hosting:write | Deletes a preview. |
hosting.source_links.delete | hosting:write | Deletes a source link. |
keys.keys.delete | keys:write | Deletes a key and schedules every version's destruction. |
keys.keys.rotate | keys:write | Rotates a key: adds a version and makes it primary. Older versions keep verifying and decrypting until destroyed. |
keys.keys.sign | keys:sign | Signs data or a digest with a SIGN key. Every use is audited. |
keys.keys.verify | keys:verify | Verifies a signature made by a SIGN key. |
keys.keys.encrypt | keys:encrypt | Encrypts data with an ENCRYPT key. |
keys.keys.decrypt | keys:decrypt | Decrypts a ciphertext made by Encrypt with this key. |
keys.keys.mac_sign | keys:sign | Computes a MAC of data with a MAC key. |
keys.keys.mac_verify | keys:verify | Verifies a MAC made by a MAC key, in constant time. |
keys.key_versions.destroy | keys:write | Schedules a key version's destruction after a 24-hour grace; the primary version cannot be destroyed. |
knowledge.spaces.delete | knowledge:write | Deletes 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.episodes.create | knowledge:write | Records an episode and returns at once (remember); extraction reads it afterwards. |
knowledge.entities.create | knowledge:write | Creates 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.merge | knowledge:write | Merges 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.split | knowledge:write | Splits a merged entity back out of this one, with the facts and external ids it brought. |
knowledge.entities.recall | knowledge:read | Searches the graph (recall): hybrid lexical and semantic search over episodes and facts, fused by reciprocal rank, then at most two hops of expansion from the top entities. Returns a context pack with citations, built only from records the caller may see. |
knowledge.entities.ask | knowledge:read | Answers a question through Sylphx AI (ask), from a context pack built only from records the caller may see, with citations to its episodes. |
knowledge.relations.create | knowledge:write | Records 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.close | knowledge:write | Closes 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.delete | localization:write | Deletes a catalog. |
money.bank_transfer_accounts.get | billing:read | GetBankTransferAccount through the project-scoped bank transfer API. |
money.bank_transfer_accounts.update | billing:bank_accounts:write | UpdateBankTransferAccount through the project-scoped bank transfer API. |
money.bank_receipts.get | billing:bank_receipts:read | GetBankReceipt through the project-scoped bank transfer API. |
money.bank_receipts.record | billing:bank_receipts:write | RecordBankReceipt through the project-scoped bank transfer API. |
money.bank_receipts.resolve | billing:bank_receipts:write | ResolveBankReceipt through the project-scoped bank transfer API. |
money.bank_receipts.reverse | billing:bank_receipts:write | ReverseBankReceipt through the project-scoped bank transfer API. |
money.processor_events.retry | billing:processor_events:write | Schedules a held event through the existing idempotent application path. The decision is audited; an etag is required. |
money.processor_events.dismiss | billing:processor_events:write | Dismisses only a held test-mode payout observation, retaining the row and audit. Live, unknown-mode and payment events are refused. |
money.merchant_accounts.update | billing:write | Updates the merchant account's own settings: the fields named in update_mask. |
money.price_catalogs.sync | billing:write | Pushes the catalog to the merchant account's processor now: products and prices by lookup key; an amount change makes a new price. |
money.store_purchases.verify | billing:write | Verifies a store purchase with the store, binds it to the subject, and returns its record and a signed grant. Re-verifying returns the same record and grant. Called from the app's server with a secret key that holds billing:write; a publishable key cannot call it. |
money.store_purchases.client_verify | billing:client | Verifies a store purchase for an app with no server: called with the environment's publishable key (billing:client), the subject is an install id (inst_ and a UUID), and Money completes the purchase with the store (acknowledges or consumes it) so the app never calls the store's server API. Works only on store connections that set client_verify. Re-calling returns the same record and grant. |
money.store_purchases.report_usage | billing:write | Reports 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.cancel | billing:write | Cancels a web subscription, now or at the period end, and optionally refunds its last payment (for example a statutory cancellation window). |
money.customer_subscriptions.resume | billing:write | Resumes a web subscription set to cancel at its period end. |
money.customer_subscriptions.update_quantity | billing:write | Changes 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_plan | billing:write | Move a web subscription onto another recurring catalog plan. |
money.test_clocks.create | billing:write | Creates a test-only Stripe simulation before the subject's first checkout. No catalogue, payment, subscription, or entitlement is changed. |
money.test_clocks.get | billing:read | Reads the owned test clock back from Stripe. Live keys are refused. |
money.test_clocks.advance | billing:write | Advances Stripe time, never entitlements. Stripe processes asynchronously; poll GetTestClock until ready, then observe the genuine webhook's effects. Time only moves forward, within Stripe's subscription-interval bound. |
money.checkout_sessions.create | billing:write | Creates a hosted checkout for a subject. |
money.checkout_sessions.expire | billing:write | Expires an open hosted checkout so it can no longer be paid. |
money.checkout_sessions.refund | billing:write | Refund all or part of a paid one-time checkout. |
money.portal_sessions.create | billing:write | Creates a customer portal session for a subject. |
money.usage_reservations.create | billing:metering:write | Reserves 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.settle | billing:metering:write | Settles a reservation with what was used; the unused part returns to headroom. A settle after expiry still records the usage. |
money.usage_reservations.release | billing:metering:write | Releases a reservation that used nothing. |
money.usage_events.create | billing:metering:write | Records usage directly, only for a meter the merchant marked reservation-optional. |
money.usage_events.batch_ingest | billing:metering:ingest | Records a batch of already-incurred usage from the merchant's own servers (Stripe's meter-event model): the caller is a key of the merchant's own org holding the exact grant billing:metering:ingest, which no wildcard covers, and each event names its subject with no subject proof. Each event is keyed by its project, meter, meter version and event id: a replay is a no-op (duplicate), and the same key with different content is a conflict and never counted. One result per event, in request order. |
money.credit_grants.create | billing:credits.approve | Gives 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_collection | billing:credits.approve | Releases a held invoice for collection, audited with who and why. Grant expiry or replacement never does. |
money.usage_meters.update | billing:write | Creates or updates a usage meter. The unit cannot change once it has recorded usage. |
money.usage_meter_prices.create | billing:write | Appends a price to a meter's history. It applies from its effective time on and never rewrites usage already rated. |
money.revenue_sources.delete | revenue:write | Deletes a revenue source and the facts it reported. The money source cannot be deleted; pause it instead. |
money.revenue_sources.run | revenue:write | Syncs 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.delete | network:write | Deletes a domain. |
network.domains.verify | network:write | Checks the verification record now instead of at the next sweep. |
network.routes.delete | network:write | Deletes a route. |
network.egress_identities.delete | network:write | Deletes an egress identity. |
network.private_links.delete | network:write | Deletes a private link. |
notify.phone_numbers.connect | notify:write | ConnectPhoneNumber: existing provider-managed lines; execution credentials are transient. |
notify.phone_numbers.get | notify:read | GetPhoneNumber: existing provider-managed lines; execution credentials are transient. |
notify.phone_numbers.list | notify:read | ListPhoneNumbers: existing provider-managed lines; execution credentials are transient. |
notify.phone_numbers.apply_route | notify:write | ApplyPhoneNumberRoute: existing provider-managed lines; execution credentials are transient. |
notify.phone_numbers.probe | notify:write | ProbePhoneNumber: existing provider-managed lines; execution credentials are transient. |
notify.phone_numbers.read_voicemail | notify:read | ReadPhoneNumberVoicemail: existing provider-managed lines; execution credentials are transient. |
notify.recipients.register_push_device | notify:write | Atomically registers or renews one Web Push subscription. Other devices remain registered. The sender and recipient must share an environment. |
notify.messages.create | notify:send | Sends a Message. |
notify.messages.cancel | notify:send | Cancels a Message whose deliveries have not been handed off. |
notify.mailbox_connect_links.create | notify:write | Mints a mailbox connect link for one end user; the response carries its url, which no later call returns. |
notify.inbox_items.mark_read | notify:write | Marks an inbox item read. |
notify.inbox_items.mark_unread | notify:write | Marks an inbox item unread. |
notify.inbox_items.archive | notify:write | Archives an inbox item. |
notify.broadcasts.send | notify:send | Sends a Broadcast now. |
notify.broadcasts.cancel | notify:send | Cancels a Broadcast; messages already admitted still deliver. |
notify.sms_numbers.create | notify:write | Provisions one carrier number within explicit cost limits and receives its SMS. |
notify.sms_numbers.adopt | notify:write | Adopts an existing active carrier SMS number binding into one environment without purchasing a new number. |
notify.support_inboxes.get | notify:support:read | Gets one SupportInbox; protected identities require a separately audited reveal. |
notify.support_inboxes.list | notify:support:read | Lists scoped support_inboxes; no cross-tenant or internal-message projection. |
notify.support_inboxes.create | notify:support:configure | Creates an idempotent SupportInbox; changed replay and illegal state are refused. |
notify.support_inboxes.update | notify:support:configure | Updates configuration with a strong ETag; intake never creates a missing inbox. |
notify.support_cases.get | notify:support:read | Gets one SupportCase; protected identities require a separately audited reveal. |
notify.support_cases.list | notify:support:read | Lists scoped support_cases; no cross-tenant or internal-message projection. |
notify.support_cases.create | notify:support:operate | Creates an idempotent SupportCase; changed replay and illegal state are refused. |
notify.support_cases.apply_support_decision | notify:support:operate | Atomically 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_signal | notify:support:ingest | Admits 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_requester | notify:support:reveal | Reveals the protected case requester under a purpose-bound grant and appends an audited read. |
notify.support_cases.import | notify:support:import | Imports 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.get | notify:support:read | Gets one SupportThreadMessage; protected identities require a separately audited reveal. |
notify.support_thread_messages.list | notify:support:read | Lists scoped support_thread_messages; no cross-tenant or internal-message projection. |
notify.support_thread_messages.create | notify:support:operate | Creates an idempotent SupportThreadMessage; changed replay and illegal state are refused. |
notify.support_actions.get | notify:support:read | Gets one SupportAction; protected identities require a separately audited reveal. |
notify.support_actions.list | notify:support:read | Lists scoped support_actions; no cross-tenant or internal-message projection. |
notify.support_actions.create | notify:support:actions | Creates an idempotent SupportAction; changed replay and illegal state are refused. |
notify.support_actions.begin_support_action_attempt | notify:support:dispatch | Claims one fenced attempt of a conclusively dispatchable action. An expired in-flight claim becomes UNCERTAIN, never PENDING. |
notify.support_actions.record_support_action_receipt | notify:support:receipts | Records an authenticated immutable authority receipt. Transport state changes alone never change a case or business action. |
notify.support_actions.reconcile | notify:support:reconcile | Queries 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_audit_events.get | notify:support:read | Gets one SupportAuditEvent; protected identities require a separately audited reveal. |
notify.support_audit_events.list | notify:support:read | Lists scoped support_audit_events; no cross-tenant or internal-message projection. |
notify.support_reconciliations.get | notify:support:read | Gets one SupportReconciliation; protected identities require a separately audited reveal. |
notify.support_reconciliations.list | notify:support:read | Lists scoped support_reconciliations; no cross-tenant or internal-message projection. |
notify.support_reconciliations.run | notify:support:reconcile | Runs one scoped daily census, dense due pass or migration comparison on demand. Incomplete coverage never proves zero exceptions. |
observability.error_groups.acknowledge | observability:write | Acknowledges an error group. |
observability.error_groups.resolve | observability:write | Resolves an error group; a new occurrence reopens it. |
observability.error_groups.reopen | observability:write | Reopens a resolved or acknowledged error group. |
release.releases.create | release:write | Creates a release: admits it and rolls it out in waves. The Operation is done when the release is live or halted. |
release.releases.deploy | release:write | Deploys 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.rollback | release:write | Rolls 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.delete | runners:write | Deletes a scale set. |
sandboxes.pools.delete | sandboxes:write | Deletes a pool. |
sandboxes.leases.renew | sandboxes:write | Extends expire_time, never past the shape's longest lease. Does not change the generation. |
sandboxes.leases.release | sandboxes:write | Ends a lease with END_REASON_RELEASED; the machine is destroyed and never leased again, and attached volumes are detached. |
sandboxes.leases.pause | sandboxes:write | Pauses a lease: its disk is kept and its machine destroyed; the generation increases. Process memory is not kept. |
sandboxes.leases.resume | sandboxes:write | Resumes a paused lease on a machine granted now, or refuses it; the generation increases. |
sandboxes.leases.set_network | sandboxes:write | Replaces a running lease's outbound policy. The generation does not change; the new policy applies before the call returns. |
sandboxes.leases.mint_token | sandboxes:exec | Mints 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.exec | sandboxes:exec | Dispatches 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.read_file | sandboxes:exec | Reads one file from the lease, at most 16 MiB; larger files use the guest's /files. |
sandboxes.leases.write_file | sandboxes:exec | Writes one file in the lease, at most 16 MiB, creating parent directories. |
sandboxes.leases.list_files | sandboxes:exec | Lists one directory in the lease. |
sandboxes.leases.remove_file | sandboxes:exec | Removes one file or directory tree in the lease. |
sandboxes.leases.open_port | sandboxes:exec | Exposes a guest port. |
sandboxes.leases.close_port | sandboxes:exec | Stops exposing a guest port. |
sandboxes.leases.act | sandboxes:exec | Performs computer actions on a DESKTOP, BROWSER, or ANDROID lease, in order, and returns each action's result and, when screenshot is set, the screenshot taken after the last action. The actions are the Anthropic computer tool's and OpenAI computer use's, one-to-one. Refused CONTROL_HELD_BY_HUMAN while a human holds control. |
sandboxes.leases.open_stream | sandboxes:exec | Opens a read-only live view of a lease's display: a short-lived viewer token bound to the lease and its generation, an embeddable URL, and the WebRTC signaling endpoint with ICE servers. Input needs control (AcquireLeaseControl). |
sandboxes.leases.acquire_control | sandboxes:exec | Takes exclusive input control of a lease's display. A HUMAN acquire preempts an AGENT holder and returns a controller stream; an AGENT acquire is refused CONTROL_HELD_BY_HUMAN while a human holds control. Control lapses at ttl, which the platform caps at 30 minutes. |
sandboxes.leases.install_app | sandboxes:exec | Installs an Android app (APK) on an ANDROID lease. |
sandboxes.volumes.archive | sandboxes:write | Archives an idle standard workspace without changing its identity or destroying its files. Ordinary attachment restores the retained copy. Validation reports eligibility and copy coverage without changing state. |
sandboxes.snapshots.create | sandboxes:write | Captures a running lease's disk as a snapshot. |
secrets.secrets.delete | secrets:write | Deletes a secret and destroys every version. |
secrets.secret_versions.disable | secrets:write | Disables a secret version: bindings stop delivering it. |
secrets.secret_versions.enable | secrets:write | Enables a disabled secret version. |
secrets.secret_versions.destroy | secrets:write | Destroys a secret version's value irrecoverably. |
secrets.secret_versions.access | secrets:access | Reads a secret version's value back. Break-glass: a separate permission, audited on every call, and never exposed to MCP. |
secrets.secret_bindings.delete | secrets:write | Deletes a secret binding. |
secrets.profiles.delete | secrets:write | Deletes a profile; with force, a profile that has versions too, which destroys every version. |
secrets.profiles.commit | secrets:mount | Writes 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.schedules.pause | workflows:write | Pauses a Schedule: no fire starts a Run until it is resumed. |
workflows.schedules.resume | workflows:write | Resumes a paused Schedule; missed fires follow catchup_window. |
workflows.runs.signal | workflows:run | Sends 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.cancel | workflows:run | Requests 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.delete | workflows:write | Deletes a job. |
workflows.job_runs.create | workflows:run | Starts 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_pinned | workflows:run | Starts 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.cancel | workflows:run | Cancels a job run: SIGTERM, then SIGKILL after 30s. A closed run fails with INVALID_STATE. |
workflows.distributed_jobs.delete | workflows:write | Deletes a distributed job. |
workflows.distributed_runs.create | workflows:run | Starts a run of a distributed job. The same Idempotency-Key returns the same run for 24h. |
workflows.distributed_runs.cancel | workflows:run | Cancels 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_shards | workflows:run | Appends shards to a run started with an open manifest; close ends the manifest, and the run ends once those shards are done. |