Events

Events record committed account and resource changes. They are a recovery aid, not permission to act after authority expires. Use after and wait on the events endpoint; a long poll returns as soon as an event exists or after at most 30 seconds with an empty list.

Cursors and history

The response contains data and next_cursor, without the ordinary paginator's has_more. Retain the cursor after processing a batch. History is 30 days. Key restrictions filter visibility, so a limited key cannot use events to enumerate unrelated resources. Reconnect with current authorization and reconcile important state through its resource endpoint.

Lifecycle and billing

Operation success, verified resource state and completion events share the original transaction boundary. Accepted work is not completion. Timeout warnings belong to a particular deadline version; obsolete warnings do not extend a run. Balance notices, retention and deletion events reflect guarded decisions, not merely a timer passing. Queued or relay-submitted mail is not proof that the destination accepted it.

Webhooks

Account webhook management is not available at launch. This does not disable incoming guest hooks, which are a different feature. Use event long polling for current account events and Hooks for bounded incoming requests to a running computer. The event types are listed below; their payloads are defined in the API reference.

Event types

Event	Meaning
`computer.created`	A computer record and its create operation were committed.
`computer.state_changed`	A computer changed state.
`computer.ready`	A computer became ready.
`computer.timeout_expiring`	The run timer expires in about five minutes.
`computer.setup_finished`	The setup script finished.
`computer.suspended`	A computer was suspended (for example by low-balance retention).
`computer.memory_discard_scheduled`	Saved memory will be discarded (notice).
`computer.memory_discarded`	Saved memory was discarded.
`computer.deletion_scheduled`	A deletion was scheduled.
`computer.deletion_held`	A scheduled deletion is on hold.
`computer.capacity_released`	An always-on slot was released.
`computer.deleted`	A computer was purged.
`snapshot.created`	A snapshot was created.
`snapshot.restored`	A snapshot was restored.
`snapshot.deleted`	A snapshot was removed.
`image.created`	A private image was created.
`image.deleted`	A private image was removed.
`billing.topup_credited`	A top-up was credited.
`billing.topup_review`	A top-up needs a decision.
`billing.low_balance`	About 72 or 24 hours of runway remain.
`billing.balance_exhausted`	Available balance reached zero.
`billing.spend_limit_reached`	The monthly spend limit was reached.
`account.tier_changed`	The account's trust tier changed.
`account.deletion_scheduled`	Account deletion was scheduled.

Dory is in development; these pages describe the planned service and may change. Questions: support@computeengines.com.