On this page
RESOURCE_NOT_FOUND
The named Resource does not exist or is not visible.
The named Resource does not exist or is not visible.
HTTP 404 · gRPC NOT_FOUND · the error body
Returned by
| Method | Scope | What it does |
|---|---|---|
access.orgs.get | access:read | Gets an org. |
access.orgs.update | access:admin | Updates an org. |
access.orgs.delete | access:admin | Deletes an org and everything in it. Deletion cascades through every service, so it returns an Operation. |
access.projects.get | access:read | Gets a project. |
access.projects.update | access:admin | Updates a project. |
access.projects.delete | access:admin | Deletes a project. |
access.envs.get | access:read | Gets an environment. |
access.envs.update | access:admin | Updates an environment. |
access.envs.delete | access:admin | Deletes an environment. |
access.service_enablements.get | access:read | Gets a service enablement. |
access.service_enablements.update | access:admin | Enables or disables a service on a project (spec.enabled). |
access.api_keys.get | access:read | Gets an API key. |
access.api_keys.update | access:keys:write | Updates an API key. |
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.get | agents:sessions | Returns hashes and original/destination mappings, never private payload. |
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.get | agents:read | Gets an agent. |
agents.agents.update | agents:write | Updates an agent. A change to spec mints the next AgentVersion; sessions already started keep the version they pinned. |
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.agent_versions.get | agents:read | Gets an agent version. |
agents.agent_sessions.get | agents:sessions | Gets a session. |
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.get | agents:sessions | Reads the exact Goal, including its terminal receipt after a successor starts. |
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.get | agents:sessions | Reads an exact wait and its retained evidence. |
agents.waits.list | agents:sessions | Lists durable waits, including ready undelivered owners. |
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.get | agents:sessions | Reads the state of an exact future-turn authorization. |
agents.queued_executions.cancel | agents:sessions | Cancels only a queued future execution; an already admitted turn retains its receipt. |
agents.session_events.get | agents:sessions | Gets a session event. |
agents.session_events.list | agents:sessions | Lists a session's events in sequence order. To follow a session, call again with the filter sequence > N, N the last sequence read; wait holds the call open until a newer event is appended or the wait ends. |
agents.memory_stores.get | agents:read | Gets a memory store. |
agents.memory_stores.update | agents:write | Updates a memory store. |
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.get | agents:sessions | Gets a memory. |
agents.memories.list | agents:sessions | Lists a store's memories, newest first. With a publishable key, only the caller's end user's memories. |
agents.memories.update | agents:write | Changes a memory's content. |
agents.memories.delete | agents:sessions | Deletes a memory. An end user may delete their own. |
agents.memories.search | agents:sessions | Recalls the memories that best match a query, by hybrid full-text and vector search. With a publishable key, only the caller's end user's memories. A read with a request body, like a query. |
agents.owner_pools.get | agents:read | Gets an owner pool with its members. |
agents.owner_pools.update | agents:admin | Replaces an owner pool's spec (agents:admin). Members keep their standing; a changed suite or minimum applies from the next :qualify. |
agents.owner_pools.delete | agents:admin | Deletes an owner pool and its members (agents:admin). Sessions already admitted keep running. |
agents.owner_pools.qualify | agents:qualify | Records 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.observe | agents:qualify | Records 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. |
ai.ai_models.get | ai:read | Gets an AI model. |
artifacts.artifacts.get | artifacts:read | Gets an artifact. |
artifacts.artifacts.delete | artifacts:write | Deletes an artifact; fails while a Release references it or a legal hold is active. |
artifacts.artifact_references.update | artifacts:retain | Updates a holder's retention reference, or creates it with allow_missing. Existing expiry is only extended, never shortened. The exact repository and digest must have an owned Artifact receipt. Success means the registry protection tag has been written and read back; a failed pin attempt commits no reference. Concurrent updates never shorten retention. |
artifacts.artifact_references.get | artifacts:read | Gets an exact holder reference, including its current expiry. |
assets.assets.get | assets:read | Gets an asset. |
assets.assets.generate | assets:write | Records 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_variant | assets:write | Approves one variant and records who approved it. |
assets.assets.reject_variant | assets:write | Rejects one variant. Its slot is freed and the next :generate fills it; the rejected file keeps serving at its URL. |
assets.assets.retire_variant | assets:write | Retires one variant. Its URL answers 404 from then on and its slot is freed. |
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.get | auth:read | Gets an end user. |
auth.end_users.update | auth:write | Updates an end user. |
auth.end_users.delete | auth:write | Deletes an end user. |
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.end_users.find | auth:read | Finds the one end user of one of the customer's own ids. An id that belongs to no live user of this environment is RESOURCE_NOT_FOUND, the same answer a value erased with its user gives. |
auth.auth_configs.get | auth:read | Gets an auth config. |
auth.auth_configs.update | auth:write | Updates an auth config. |
auth.sessions.get | auth:read | Gets a session. |
auth.sessions.revoke | auth:write | Revokes a session. |
auth.identities.get | auth:read | Gets an identity of an end user. |
auth.identities.list | auth:read | Lists the identities an end user signs in with. |
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.customer_organizations.get | auth:read | Gets a customer organization. |
auth.customer_organizations.update | auth:write | Updates a customer organization. |
auth.customer_organizations.delete | auth:write | Deletes a customer organization. |
auth.memberships.get | auth:read | Gets a membership. |
auth.memberships.update | auth:write | Updates a membership. |
auth.memberships.delete | auth:write | Deletes a membership. |
auth.organization_roles.get | auth:read | Gets an organization role. |
auth.organization_roles.update | auth:write | Updates an organization role. |
auth.organization_roles.delete | auth:write | Deletes an organization role. |
auth.trusted_issuers.get | auth:read | Gets an trusted issuer. |
auth.trusted_issuers.update | auth:write | Updates an trusted issuer. |
auth.trusted_issuers.delete | auth:write | Deletes an trusted issuer. |
auth.invitations.get | auth:read | Gets 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.get | auth:read | Gets an email domain. |
auth.email_domains.delete | auth:write | Deletes an email domain. |
auth.email_domains.verify | auth:write | Looks up the domain's TXT record now; found, the domain is verified. |
auth.oauth_clients.get | auth:read | Gets an OAuth client. |
auth.oauth_clients.update | auth:write | Updates an OAuth client. |
auth.oauth_clients.delete | auth:write | Deletes an OAuth client. |
auth.oauth_clients.roll_secret | auth:write | Issues a new client secret, returned once; the old one verifies until grace_period ends. |
billing.meters.get | billing:read | Gets a meter. |
billing.plans.get | billing:read | Gets a plan. |
billing.billing_accounts.get | billing:read | Gets a billing account. |
billing.billing_accounts.update | billing:admin | Updates a billing account: changes plan, spend limit, or billing email. |
billing.billing_accounts.setup_payment_method | billing:admin | Starts saving a payment method for the org: returns a client secret the console confirms with Stripe.js, so card data never reaches Sylphx. The saved method becomes the account's default and is charged off-session for each finalized invoice. |
billing.invoices.get | billing:read | Gets an invoice. |
billing.invoices.record_payment | billing:payments:record | A 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. |
billing.usage_reports.get | billing:read | Gets an usage report. |
billing.budget_leases.get | billing:read | Gets a budget lease. |
broker.trust_policies.get | broker:read | Gets a trust policy. |
broker.trust_policies.update | broker:admin | Updates a trust policy. |
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. |
broker.token_exchanges.get | broker:read | Gets the record of one issued credential. |
broker.token_exchanges.revoke | broker:read | Revokes an issued credential at the provider by its record. The Broker uses the credential it holds sealed, so the caller needs no token and no live delegation. Idempotent: a credential already revoked or expired answers the record. Erases the sealed credential once the provider confirms. |
build.builds.get | build:read | Gets a build. |
build.builds.cancel | build:run | Cancels a queued or running Build; its lease is released and nothing is published. |
build.builds.read_logs | build:read | Reads a page of a build's log lines, oldest first. With wait, an empty page on a running build waits up to that long for new lines, so a client follows the log by passing each next_page_token back. |
build.build_caches.get | build:read | Gets a build cache. |
build.build_caches.update | build:write | Updates a build cache. |
build.build_caches.delete | build:write | Deletes a build cache. |
build.build_caches.mint_env | build:run | Mints 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.purge | build:write | Empties a build cache and keeps the cache. The undo is that the next build refills it. |
config.config_flags.get | config:read | Gets a config flag. |
config.config_flags.update | config:write | Updates a config flag; the change rolls out in waves and the Operation is done when every cell serves it. |
config.config_flags.delete | config:write | Deletes a config flag; evaluators then get their compiled-in fallback. |
config.config_segments.get | config:read | Gets a config segment. |
config.config_segments.update | config:write | Updates a config segment; every flag naming it follows. |
config.config_segments.delete | config:write | Deletes a config segment; refused while a flag names it. |
config.config_changes.get | config:read | Gets a config change. |
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.get | connections:read | Gets a connection provider. |
connections.connection_providers.update | connections:admin | Updates a connection provider. |
connections.connection_providers.delete | connections:admin | Deletes a connection provider; force forgets its local connections only. |
connections.connections.get | connections:read | Gets a connection. |
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.update | connections:write | Updates a connection's metadata. |
connections.connections.delete | connections:write | Forgets a connection. The installation itself is removed at the provider. |
data.objects.put | data:write | Writes an object's bytes, replacing the current version. body is the base64 of the bytes. |
data.objects.get | data:read | Reads an object and its bytes (body, base64). |
data.objects.list | data:read | Lists a bucket's objects in key order. |
data.objects.delete | data:write | Deletes an object's current version (history is kept). |
data.kv.put | data:write | Writes a value. Without ttl_seconds the namespace default applies; zero means no expiry. |
data.kv.get | data:read | Reads a value. |
data.kv.list | data:read | Lists a namespace's values in key order. |
data.kv.delete | data:write | Deletes a value. |
data.kv.increment | data:write | Adds delta (default 1) to an integer value, creating it at zero. |
data.kv.get_many | data:read | Reads up to 1000 keys at once (MGET). Answers one entry per key, in order; an absent or expired key keeps its key and has no value. |
data.kv.hash_set | data:write | Sets fields of a hash (HSET), creating it. |
data.kv.hash_get | data:read | Reads one field of a hash (HGET); an absent field has no value. |
data.kv.hash_get_all | data:read | Reads every field of a hash (HGETALL). |
data.kv.hash_get_many | data:read | Reads several fields of a hash (HMGET), one per field, in order; an absent field has no value. |
data.kv.list_push | data:write | Pushes values onto the head of a list (LPUSH), creating it. |
data.kv.list_range | data:read | Reads a range of a list (LRANGE); negative indexes count from the end. |
data.kv.list_pop | data:write | Pops values from the head of a list (LPOP); an emptied list is removed. |
data.kv.list_length | data:read | Reads the length of a list (LLEN); an absent key has length zero. |
data.kv.zset_add | data:write | Adds members to a sorted set or updates their scores (ZADD), creating it. |
data.kv.zset_range | data:read | Reads a range of a sorted set by rank, lowest score first (ZRANGE); negative indexes count from the end. |
data.kv.zset_score | data:read | Reads a member's score (ZSCORE); an absent member has no score. |
data.kv.zset_length | data:read | Reads the size of a sorted set (ZCARD); an absent key has size zero. |
data.kv.scan | data:read | Walks a namespace's keys that match a glob (SCAN). Call again with the returned cursor until it is empty. |
data.kv.expire | data:write | Sets a key's time to live (EXPIRE) without rewriting its value; zero makes it persistent. |
data.documents.put | data:write | Writes a document to a search index, replacing the current version. |
data.documents.patch | data:write | Changes some fields of a document and keeps the rest: a JSON merge patch (RFC 7396). The version goes up by one. |
data.documents.get | data:read | Reads a document. |
data.documents.delete | data:write | Deletes a document. |
data.search.query | data:read | Searches an index by text, by vector, or both, best match first, with filters and paging. |
data.search.multi | data:read | Runs several searches of one index in one request, 1 to 10, and answers each in request order. |
data.databases.get | data:read | Gets a database. |
data.databases.check_catalog_readiness | data:read | Observes aggregate-read coverage using the database's approved reader. Reads catalog metadata only; never accepts SQL, credentials or row data. |
data.databases.update | data:write | Updates 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.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.get | data:read | Gets a kv namespace. |
data.kv_namespaces.update | data:write | Updates a kv namespace. |
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.get | data:read | Gets a bucket. |
data.buckets.update | data:write | Updates 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.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.get | data:read | Gets a search index. |
data.search_indexes.update | data:write | Updates a search index. |
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. |
entitlement.entitlements.get | entitlement:read | Gets an org's entitlement. |
events.topics.get | events:read | Gets a topic. |
events.topics.update | events:write | Updates a topic. |
events.topics.delete | events:write | Deletes a topic. |
events.topics.publish | events:publish | Publishes CloudEvents into a Topic, atomically. Replaying the same source + id with the same payload returns the stored event; a different payload fails with RESOURCE_ALREADY_EXISTS. |
events.events.publish_service_event | events:publish | Publishes 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.events.get | events:read | Gets an event. |
events.connectors.get | events:read | Gets a connector. |
events.subscriptions.get | events:read | Gets a subscription. |
events.subscriptions.update | events:write | Updates a subscription. |
events.subscriptions.delete | events:write | Deletes a subscription. |
events.queues.get | events:read | Gets a queue. |
events.queues.update | events:write | Updates a queue. |
events.queues.delete | events:write | Deletes a queue. |
events.queues.send | events:publish | Enqueues messages directly, without a Subscription. |
events.queues.lease | events:write | Leases up to max_messages ready messages for the visibility timeout. |
events.queues.ack | events:write | Acknowledges leased messages; each is removed. A lease that is stale (expired or superseded) is reported, not applied. |
events.queues.nack | events:write | Returns leased messages to the Queue after delay; each nack counts as a delivery. |
events.queues.replay | events:write | Moves dead-lettered messages, optionally bounded by dead-letter time, back to ready. |
events.webhook_endpoints.get | events:read | Gets a webhook endpoint. |
events.webhook_endpoints.update | events:write | Updates a webhook endpoint. |
events.webhook_endpoints.delete | events:write | Deletes a webhook endpoint. |
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.rotate_secret | events:write | Replaces 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.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.get | events:read | Gets a webhook delivery. |
events.webhook_deliveries.replay | events:write | Redelivers one delivery now, as a new attempt. |
events.inbound_endpoints.get | events:read | Gets an inbound endpoint. |
events.inbound_endpoints.update | events:write | Updates an inbound endpoint. |
events.inbound_endpoints.delete | events:write | Deletes an inbound endpoint. |
events.realtime_channels.get | events:read | Gets a realtime channel. |
events.realtime_channels.update | events:write | Updates a realtime channel. |
events.realtime_channels.publish | events:publish | Publishes 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.issue_token | events:publish | Mints a subscribe token (rtt_…) for this channel alone, at most an hour long, for a browser or device that holds no key. A token that names a client id enters the channel's presence while it is connected. |
events.realtime_channels.delete | events:write | Deletes a realtime channel. |
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.get | events:read | Gets one retained message of a channel. |
events.realtime_messages.list | events:read | Lists a channel's retained messages, oldest first. |
events.realtime_messages.react | events:write | Adds or removes a member reaction on a visible Chat message. |
events.realtime_members.get | events:read | Gets one client present in a channel. |
events.realtime_members.list | events:read | Lists the clients present in a channel now. |
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.issue_token | events:write | Issues a bounded player capability after verified Auth token exchange. |
events.chat_reports.list | events:read | Lists the moderation queue. |
events.chat_reports.resolve | events:write | Records a moderation response. |
events.chat_sticker_packs.get | events:read | Gets an authoritative tenant sticker pack. |
hosting.uptime_manifests.get | hosting:read | Reads complete check declarations from the owner's selected source intent. Missing, unavailable or invalid sources are errors, never an empty set. |
hosting.serving_routes.get | hosting:read | Gets an authorized public route observation. |
hosting.serving_routes.list | hosting:read | Lists every authorized public route; follow all pages in one snapshot. |
hosting.service_observations.get | hosting:read | Reads readiness without invoking or waking a service. |
hosting.service_observations.probe | hosting:read | Performs one safe same-environment transport observation. Unlike a readiness read, this explicitly requested HTTP instrument may activate an idle service. No caller credential is forwarded to the workload. |
hosting.services.get | hosting:read | Gets a service. |
hosting.services.update | hosting:write | Updates a service. |
hosting.services.delete | hosting:write | Deletes a service. |
hosting.service_rollouts.get | hosting:read | Gets a rollout. |
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.get | hosting:read | Gets a preview. |
hosting.previews.delete | hosting:write | Deletes a preview. |
hosting.source_links.get | hosting:read | Gets a source link. |
hosting.source_links.update | hosting:write | Updates a source link. |
hosting.source_links.delete | hosting:write | Deletes a source link. |
keys.keys.get | keys:read | Gets a key. |
keys.keys.update | keys:write | Updates a key's rotation period, deletion protection, or metadata. |
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.get | keys:read | Gets a key version. |
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.get | knowledge:read | Gets a space. |
knowledge.spaces.update | knowledge:write | Updates a space. |
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.knowledge_schemas.get | knowledge:read | Gets a knowledge schema. |
knowledge.knowledge_schemas.update | knowledge:write | Updates 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.delete | knowledge:write | Deletes a knowledge schema. A schema a space still accepts is refused with RESOURCE_IN_USE. |
knowledge.episodes.get | knowledge:read | Gets an episode. |
knowledge.episodes.delete | knowledge:write | Deletes 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.get | knowledge:read | Gets an entity. |
knowledge.entities.update | knowledge:write | Updates 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.delete | knowledge:write | Deletes 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.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.profile | knowledge:read | Returns one entity's profile in one call (entity): the entity, its current facts in both directions, the entities they name and the recent episodes about it, trimmed to what the caller may see. A read with a request body. |
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.get | knowledge:read | Gets a relation. |
knowledge.relations.delete | knowledge:write | Deletes a fact. Deletion is for data that must go; a fact that stopped being true is closed with :close. |
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.get | localization:read | Gets a catalog. |
localization.catalogs.update | localization:write | Updates a catalog. |
localization.catalogs.delete | localization:write | Deletes a catalog. |
localization.catalogs.sync | localization:write | Reads 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.catalogs.export | localization:read | Returns the catalog's files per locale in the requested format, with the QA report. A read with a request body, like a query. |
localization.entries.get | localization:read | Gets a catalog entry. |
localization.entries.pin_translation | localization:write | Sets 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_translation | localization:write | Removes the human override of one locale; the next sync may translate it again. |
localization.glossaries.get | localization:read | Gets a glossary. |
localization.glossaries.update | localization:write | Updates a glossary. |
localization.glossaries.delete | localization:write | Deletes a glossary. |
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.get | billing:processor_events:read | Gets one stored processor hint, with its safe hold reason. |
money.processor_events.list | billing:processor_events:read | Lists stored processor hints; defaults to held events. |
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.check_processor_permissions | billing:read | Checks Payouts and Balance read without modifying a merchant, its key or checkout. |
money.merchant_accounts.get | billing:read | Gets a merchant account. |
money.merchant_accounts.refresh | billing:write | Reads the connected account back from the processor. |
money.merchant_accounts.disconnect | billing:write | Disconnects the account: Sylphx loses access; checkout is refused. |
money.merchant_accounts.update | billing:write | Updates the merchant account's own settings: the fields named in update_mask. |
money.price_catalogs.get | billing:read | Gets the environment's catalog. |
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.checkout_policies.get | billing:read | Gets the environment's checkout policy: which buyer countries consumer checkout refuses. An environment that never wrote one refuses none. |
money.store_connections.get | billing:read | Gets a store connection. |
money.store_connections.update | billing:write | Updates a store connection; a new credential replaces the stored one. |
money.store_connections.delete | billing:write | Deletes a store connection and its sealed credential. |
money.store_purchases.get | billing:read | Gets a store purchase. |
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.store_consumption_requests.get | billing:read | Gets a captured store consumption request. |
money.customer_subscriptions.get | billing:read | Gets a customer subscription. |
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.entitlement_grants.get | billing:read | Gets an entitlement grant. |
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.get | billing:read | Gets a checkout session. |
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.portal_sessions.get | billing:read | Gets a portal session. |
money.licence_keys.retire | billing:licence_keys.approve | Retires a licence key: it stops signing new terms and stays exported for verification. |
money.licence_keys.get | billing:read | Gets a licence key (its public half, never the private). |
money.usage_settings.get | billing:read | Gets the environment's usage settings. |
money.usage_reservations.get | billing:read | Gets a usage reservation. |
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.credit_grants.get | billing:read | Gets a credit grant. |
money.usage_invoices.get | billing:read | Gets a usage invoice. |
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.get | billing:read | Gets a usage meter. |
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.get | revenue:read | Gets a revenue source, with its freshness. Revenue reporting (docs/adr/ADR-01M40HRQT0VSXZ1WANP8M318F2) is org-wide: revenue:read or revenue:write, held by an org-wide key or an org owner's or admin's session only; a project or environment key is refused. |
money.revenue_sources.update | revenue:write | Renames, pauses or resumes a revenue source, or changes its settings. |
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). |
money.revenue.get | revenue:read | Gets the org's revenue over a period: totals by day or month, split by source or product, gross or net, in one reporting currency, with the basis of each bucket, the sources that report late, and what has no rate yet. Reads only the daily roll-up, bounded by a 5 second statement timeout. For example sylphx money revenue summary --period mtd --split source. |
network.domains.get | network:read | Gets a domain. |
network.domains.update | network:write | Updates a domain. |
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.certificates.get | network:read | Gets a certificate. |
network.routes.get | network:read | Gets a route. |
network.routes.update | network:write | Updates a route. |
network.routes.delete | network:write | Deletes a route. |
network.egress_identities.get | network:read | Gets an egress identity. |
network.egress_identities.update | network:write | Updates an egress identity. |
network.egress_identities.delete | network:write | Deletes an egress identity. |
network.private_links.get | network:read | Gets a private link. |
network.private_links.update | network:write | Updates a private link. |
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.mail_domains.get | notify:read | Gets an email domain. |
notify.mail_domains.update | notify:write | Updates an email domain. |
notify.mail_domains.delete | notify:write | Deletes an email domain. |
notify.mail_domains.verify | notify:write | Checks the domain's DNS records now instead of on the next sweep. |
notify.mail_routes.get | notify:read | Gets a route. |
notify.mail_routes.list | notify:read | Lists an email domain's routes. |
notify.mail_routes.create | notify:write | Creates a route. |
notify.mail_routes.update | notify:write | Updates a route. |
notify.mail_routes.delete | notify:write | Deletes a route. |
notify.senders.get | notify:read | Gets a sender. |
notify.senders.update | notify:write | Updates a sender. |
notify.senders.delete | notify:write | Deletes a sender. |
notify.senders.verify | notify:write | Re-checks the sender's registration or credentials now. |
notify.recipients.get | notify:read | Gets a recipient. |
notify.recipients.update | notify:write | Updates a recipient. |
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.recipients.unregister_push_device | notify:write | Unregisters only the device identified by the registration receipt. A missing registration is already unregistered and succeeds. |
notify.recipients.delete | notify:write | Deletes a recipient. |
notify.preferences.get | notify:read | Gets a preference. |
notify.preferences.update | notify:write | Updates a preference. |
notify.preferences.delete | notify:write | Deletes a preference. |
notify.message_topics.get | notify:read | Gets a message topic. |
notify.message_topics.update | notify:write | Updates a message topic; with allow_missing, creates it. |
notify.message_topics.delete | notify:write | Deletes a message topic; its messages are admitted with no gate or topic limit. |
notify.suppressions.get | notify:read | Gets a suppression. |
notify.suppressions.delete | notify:write | Deletes a suppression. |
notify.templates.get | notify:read | Gets a template. |
notify.templates.update | notify:write | Updates a template. |
notify.templates.delete | notify:write | Deletes a template. |
notify.messages.get | notify:read | Gets a message. |
notify.messages.cancel | notify:send | Cancels a Message whose deliveries have not been handed off. |
notify.mailboxes.get | notify:read | Gets a mailbox. |
notify.mailboxes.update | notify:write | Updates a mailbox. |
notify.mailboxes.delete | notify:write | Deletes a mailbox and its inbound email. |
notify.mailboxes.erase_address | notify:write | Removes 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.get | notify:read | Gets a mailbox OAuth app. |
notify.mailbox_oauth_apps.update | notify:write | Updates a mailbox OAuth app. |
notify.mailbox_oauth_apps.delete | notify:write | Deletes a mailbox OAuth app; refused while a mailbox uses it. |
notify.mailbox_connect_links.get | notify:read | Gets a mailbox connect link. |
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.inbound_emails.get | notify:read | Gets an inbound email. |
notify.inbound_emails.list | notify:read | Lists a mailbox's inbound email in feed order, oldest first. |
notify.inbox_items.get | notify:read | Gets an inbox item. |
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.get | notify:read | Gets a broadcast. |
notify.broadcasts.update | notify:write | Updates a broadcast. |
notify.broadcasts.delete | notify:write | Deletes a broadcast. |
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.get | notify:read | Gets an SMS number binding. |
notify.sms_numbers.delete | notify:write | Requests carrier release and stops recurring number billing. Read status until retired_time is set. Historical messages stay readable. |
notify.sms_numbers.configure_voicemail | notify:write | Configure voicemail and create an inert standalone carrier application. Never buys, attaches, forwards or changes the voice profile of a line. |
notify.inbound_sms.get | notify:read | Gets one inbound SMS. |
notify.inbound_sms.list | notify:read | Lists a number's inbound SMS in feed order, oldest first. |
notify.inbound_messages.get | notify:read | Get one message in the unified SMS and voice inbox. |
notify.inbound_messages.list | notify:read | List SMS and voice messages in sequence order. The sequence advances when asynchronous content changes, so polling also observes completed transcripts. |
notify.inbound_messages.download | notify:read | Download retained voicemail bytes with the inbox's tenant/resource permission. |
observability.uptime_sources.get | observability:read | Gets the environment's manifest subscription (uptime_sources/manifest). |
observability.uptime_checks.create | observability:write | Creates one tenant uptime check. |
observability.uptime_checks.get | observability:read | Gets one tenant uptime check. |
observability.uptime_checks.list | observability:read | Lists checks and aggregate status. GetUptimeCheck reads target pages. |
observability.uptime_checks.update | observability:write | Updates one tenant uptime check. |
observability.uptime_checks.delete | observability:write | Deletes one tenant uptime check. |
observability.log_entries.get | observability:read | Gets a log entry. |
observability.traces.get | observability:read | Gets a trace. |
observability.generations.get | observability:read | Gets a generation: one Sylphx AI call. |
observability.error_groups.get | observability:read | Gets an error group. |
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. |
observability.error_events.get | observability:read | Gets an error event. |
observability.source_maps.get | observability:read | Gets a source map (without its content). |
observability.scrubbing_policies.get | observability:read | Gets the environment's scrubbing policy (scrubbing_policies/default). |
observability.scrubbing_policies.update | observability:write | Updates the environment's scrubbing policy. |
realtime.namespaces.get | realtime:read | Reads a namespace. |
realtime.namespaces.delete | realtime:write | Deletes a namespace, its channels' history and presence, and closes the subscriptions on them. |
realtime.channels.publish | realtime:publish | Publishes a message to a channel. The namespace must exist. The server publishes regardless of client_publish. A repeated Sylphx-Effect-Id publishes once. |
realtime.channels.history | realtime:read | Lists a channel's messages after a cursor, oldest first. With wait_seconds, an empty result waits up to that long for the first new message and answers as soon as one arrives: this is how an agent subscribes. |
realtime.channels.presence | realtime:read | Lists who is present on a channel. |
realtime.bindings.create | realtime:write | Binds a bus Subscription's matching events to a channel: each event the Subscription matches is published to the channel, with the event's CloudEvents type as the message event and its data as the payload. The Subscription itself is an Events Resource (sylphx.events.v1); this call only names the channel it feeds, and replaces the Subscription's earlier binding. |
release.releases.get | release:read | Gets a release. |
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. |
release.rollouts.get | release:read | Gets a rollout. |
runners.scale_sets.get | runners:read | Gets a scale set. |
runners.scale_sets.update | runners:write | Updates a scale set. |
runners.scale_sets.delete | runners:write | Deletes a scale set. |
runners.runners.get | runners:read | Gets a runner. |
sandboxes.sandbox_shapes.get | sandboxes:read | Gets a shape. |
sandboxes.pools.get | sandboxes:read | Gets a pool. |
sandboxes.pools.update | sandboxes:write | Updates a pool. |
sandboxes.pools.delete | sandboxes:write | Deletes a pool. |
sandboxes.leases.get | sandboxes:read | Gets a lease. |
sandboxes.leases.create | sandboxes:write | Creates 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.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.cancel_exec | sandboxes:exec | Requests cancellation of the existing execution key. This acknowledgement means the request was recorded, not that the process has stopped. Observe the exact original ExecLease request for its confirmed terminal result. An already completed result wins; an unknown outcome remains unknown. |
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.release_control | sandboxes:exec | Releases control held under epoch; its controller tokens stop working. |
sandboxes.leases.get_control | sandboxes:read | Gets who holds control of a lease's display. |
sandboxes.leases.install_app | sandboxes:exec | Installs an Android app (APK) on an ANDROID lease. |
sandboxes.lease_events.get | sandboxes:read | Gets one lease event. |
sandboxes.lease_events.list | sandboxes:read | Lists a lease's events in order. With wait, blocks up to that long for an event after page_token (long poll). |
sandboxes.volumes.get | sandboxes:read | Gets a volume. |
sandboxes.volumes.update | sandboxes:write | Updates a volume: grows spec.size_gib and edits metadata. |
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.volumes.delete | sandboxes:write | Deletes a volume and destroys its data. Refused RESOURCE_IN_USE while it is attached. |
sandboxes.snapshots.get | sandboxes:read | Gets a snapshot. |
sandboxes.snapshots.create | sandboxes:write | Captures a running lease's disk as a snapshot. |
sandboxes.snapshots.delete | sandboxes:write | Deletes a snapshot. |
secrets.secrets.get | secrets:read | Gets a secret. |
secrets.secrets.update | secrets:write | Updates a secret. |
secrets.secrets.delete | secrets:write | Deletes a secret. App environment secrets are retired without erasing retained versions or changing already released configurations. |
secrets.secret_versions.get | secrets:read | Gets a secret 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.get | secrets:read | Gets a secret binding. |
secrets.secret_bindings.update | secrets:write | Updates a secret binding. |
secrets.secret_bindings.delete | secrets:write | Deletes a secret binding. |
secrets.profiles.get | secrets:read | Gets a profile: its kind, grants, sites and latest version; never a value. |
secrets.profiles.update | secrets:write | Updates a profile's grants or declared paths. Granting a mount is this call: nothing else adds a grant. |
secrets.profiles.delete | secrets:write | Deletes a profile; with force, a profile that has versions too, which destroys every version. |
secrets.profiles.open | secrets:mount | Mounts a profile for one session: returns the state of one version and, for WRITE_BACK, an attachment that :commit writes through until it expires. Every call is audited with the caller's context; the caller's principal needs a grant of at least the requested mode. |
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. |
secrets.profile_versions.get | secrets:read | Gets a profile version: its sites and lineage; never a value. |
workflows.workflows.get | workflows:read | Gets a workflow. |
workflows.workflows.update | workflows:write | Updates a workflow. |
workflows.workflows.delete | workflows:write | Deletes a workflow. |
workflows.schedules.get | workflows:read | Gets a schedule. |
workflows.schedules.update | workflows:write | Updates 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.delete | workflows:write | Deletes a schedule. |
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.get | workflows:read | Gets a run. |
workflows.runs.start_batch | workflows:run | Starts a batch: a parent Run that fans out one child Run per item, each with a stable index and count. |
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.runs.wait | workflows:read | Waits up to timeout (at most 60s) for the Run to close, then returns it, closed or not. Its short name is result: the closed Run carries the handler's output or error. 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.read_history | workflows:read | Reads a page of the Run's immutable history, projected to Sylphx events. |
workflows.jobs.get | workflows:read | Gets a job. |
workflows.jobs.update | workflows:write | Updates a job. Runs already started keep the generation they pinned. |
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.get | workflows:read | Gets a job run. |
workflows.job_runs.cancel | workflows:run | Cancels a job run: SIGTERM, then SIGKILL after 30s. A closed run fails with INVALID_STATE. |
workflows.job_runs.read_logs | workflows:run | Reads a page of a job run's log lines, oldest first. With wait, an empty page on a running run waits up to that long for new lines, so a client follows the log by passing each next_page_token back. |
workflows.distributed_jobs.get | workflows:read | Gets a distributed job. |
workflows.distributed_jobs.update | workflows:write | Updates a distributed job. Runs already started keep the generation they pinned. |
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.get | workflows:read | Gets a distributed run: its state, shard and worker counts, and usage. |
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. |
workflows.distributed_runs.read_shards | workflows:read | Reads a page of the run's shards, in queue order. |
workflows.distributed_runs.read_workers | workflows:read | Reads a page of the run's workers. |