Menu
Platform
AI
App store purchases
Credits
Database
Flags
Generated Assets
Monitoring
Notifications
Organizations
Payments
- Payments
- Payments quickstart
- Checkout policies
- Checkout sessions
- Customer subscriptions
- Entitlement grants
- Exchange rates
- Licence keys
- Licence tokens
- Merchant accounts
- Portal sessions
- Price catalogs
- Revenue
- Revenue facts
- Revenue sources
- Tax threshold statuses
- Usage events
- Usage invoices
- Usage meter prices
- Usage meters
- Usage reservations
- Usage settings
- Usage tiers
Sandboxes
Webhooks
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
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
| Method | Scope | What it does |
|---|---|---|
agents.agent_sessions.create | agents:sessions | Starts 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.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. |
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. |
build.builds.create | build:run | Creates 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.run | build:run | Runs 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_image | build:run | Builds an image, with an SBOM and signed provenance, from a commit or an uploaded tree. |
data.databases.create | data:write | Creates a database. The Operation is done when the controller settles it. |
data.kv_namespaces.create | data:write | Creates a kv namespace. The Operation is done when the controller settles it. |
data.buckets.create | data:write | Creates a bucket. The Operation is done when the controller settles it. |
data.search_indexes.create | data:write | Creates a search index. The Operation is done when the controller settles it. |
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.queues.send | events:publish | Enqueues messages directly, without a Subscription. |
hosting.services.create | hosting:write | Creates a service. The Operation is done when the controller settles it. |
hosting.service_rollouts.create | hosting:write | Creates a rollout. |
hosting.previews.create | hosting:write | Creates a preview. The Operation is done when the controller settles it. |
hosting.source_links.create | hosting:write | Creates a source link. The Operation is done when the controller settles it. |
knowledge.episodes.create | knowledge:write | Records an episode and returns at once (remember); extraction reads it afterwards. |
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. |
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. |
network.domains.create | network:write | Creates a domain. The Operation is done when the controller settles it. |
network.routes.create | network:write | Creates a route. The Operation is done when the controller settles it. |
network.egress_identities.create | network:write | Creates an egress identity. The Operation is done when the controller settles it. |
network.private_links.create | network:write | Creates a private link. The Operation is done when the controller settles it. |
observability.log_entries.write | observability:ingest | Ingests 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_spans | observability:ingest | Ingests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries. |
observability.error_groups.capture | observability:ingest | Captures 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.create | runners:write | Creates a scale set. The Operation is done when the controller settles it. |
sandboxes.pools.create | sandboxes:write | Creates a pool. The Operation is done when the controller settles it. |
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. |