Skip to content
Console
Menu

Getting Started

Authentication

KV Store

On this page

SPEND_LIMIT_REACHED

The org's spend limit is reached.

The org's spend limit is reached.

HTTP 402 · gRPC FAILED_PRECONDITION · the error body

#Returned by

MethodScopeWhat it does
agents.agent_sessions.createagents:sessionsStarts a session of an agent, pinned to its current version unless agent_version names another. Requires a secret key until end-user ownership is implemented. The session starts idle; :send starts its first turn.
agents.agent_sessions.sendagents:sessionsSends a user message. On an idle or failed session it starts a new turn; while a turn runs it is refused with INVALID_STATE (use :steer). The same Idempotency-Key returns the same event.
assets.assets.generateassets:writeRecords the recipes as assets and generates the variants that are missing. Each call is idempotent and works within a bounded time; call again until pending is 0.
build.builds.createbuild:runCreates a build: one command or one image over a commit or a tree. The Operation is done when the build reaches a final state. run and image are the short forms.
build.builds.runbuild:runRuns one command over an uploaded tree and settles with its exit code, like the local command. A caller that gets a failure before the command started (BUILD_FAILURE_SETUP_FAILED, NO_CAPACITY) may build locally.
build.builds.build_imagebuild:runBuilds an image, with an SBOM and signed provenance, from a commit or an uploaded tree.
data.databases.createdata:writeCreates a database. The Operation is done when the controller settles it.
data.kv_namespaces.createdata:writeCreates a kv namespace. The Operation is done when the controller settles it.
data.buckets.createdata:writeCreates a bucket. The Operation is done when the controller settles it.
data.search_indexes.createdata:writeCreates a search index. The Operation is done when the controller settles it.
events.topics.publishevents:publishPublishes 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.queues.sendevents:publishEnqueues messages directly, without a Subscription.
hosting.services.createhosting:writeCreates a service. The Operation is done when the controller settles it.
hosting.service_rollouts.createhosting:writeCreates a rollout.
hosting.previews.createhosting:writeCreates a preview. The Operation is done when the controller settles it.
hosting.source_links.createhosting:writeCreates a source link. The Operation is done when the controller settles it.
knowledge.episodes.createknowledge:writeRecords an episode and returns at once (remember); extraction reads it afterwards.
knowledge.entities.askknowledge:readAnswers a question through Sylphx AI (ask), from a context pack built only from records the caller may see, with citations to its episodes.
localization.catalogs.synclocalization:writeReads the source files and the committed translations into the catalog, then translates what is new or stale. Each call is idempotent and works within a bounded time; call again until pending is 0.
network.domains.createnetwork:writeCreates a domain. The Operation is done when the controller settles it.
network.routes.createnetwork:writeCreates a route. The Operation is done when the controller settles it.
network.egress_identities.createnetwork:writeCreates an egress identity. The Operation is done when the controller settles it.
network.private_links.createnetwork:writeCreates a private link. The Operation is done when the controller settles it.
observability.log_entries.writeobservability:ingestIngests a batch of log entries atomically. The same Idempotency-Key and digest replays the same batch; a different digest under the key conflicts.
observability.traces.write_spansobservability:ingestIngests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries.
observability.error_groups.captureobservability:ingestCaptures one error occurrence. It is grouped by fingerprint when the caller sets one, else by exception type and the symbolicated in-app stack; release is never part of the group. A new occurrence reopens a resolved group. Secrets and personal data are scrubbed by the environment's Scrubbing Policy before storage. A fingerprint-equal replay bills no second new-error unit. Under quota pressure the response says what to sample. Browsers call it with a publishable key that holds observability:ingest (CORS allowed, rate-limited per environment).
runners.scale_sets.createrunners:writeCreates a scale set. The Operation is done when the controller settles it.
sandboxes.pools.createsandboxes:writeCreates a pool. The Operation is done when the controller settles it.
sandboxes.leases.createsandboxes:writeCreates a lease: granted now and returned READY (or GRANTED when wait_ready is false), or refused with a typed error. There is no queue.