Reference
Generation and billing statuses
Map execution and billing states to safe polling, completion, retry, and review behavior.
On this page
Execution status and billing status are related but distinct. Always inspect both before deciding that work is complete or balance is available again.
01
Generation status
queuedActiveKeep polling. Cancellation can be requested.runningActiveKeep polling. Cancellation is best effort.succeededTerminalRead ordered output assets, structured data, and final usage.failedTerminalInspect error and usage. Retry only after classifying the failure.cancelledTerminalInspect final usage. The latest cancelled attempt may be retried.manual_reviewTerminal for automationStop automated actions until status and billing are resolved.02
Billing status
reservedThe current estimate is held while work is active.Included in reserved balance, not available balance.settledFinal usage was charged.The settled amount remains spent; unused hold can be released.releasedThe held amount was returned.Released funds are available again.manual_reviewFinal cost could not be resolved automatically.The hold remains unavailable until resolution.