Delete Graph

Body for the delete-graph operation.

Permanently destroys the graph and cancels its subscription. Two modes:

• Immediate (default): subscription canceled now (ends_at = now) and fast-path deprovisioning fires within ~10 minutes. Use when you want the data gone and the slot freed right away.
• At period end (at_period_end=true): subscription canceled but ends_at = current_period_end so the graph stays usable through the paid period. The existing suspend → deprovision sensor pipeline tears it down after the retention window once the period closes.

Requires confirm to equal the URL graph_id as a guard against accidental destructive calls.

Uniform response shape for every operation endpoint.

Every dispatch carries an op_<ULID> operation_id, which is the bridge to the monitoring surface: pass it to GET /v1/operations/{operation_id}/stream (see routers/operations.py) to subscribe to SSE progress events. Sync commands complete in the envelope itself (status: "completed", HTTP 200); async commands (status: "pending", HTTP 202) hand off to a background worker and stream their tail through that SSE endpoint. Failed dispatches still mint an operation_id so the audit log and any partial SSE events stay correlatable.

TResult parameterizes result so per-op response shapes surface in OpenAPI. Operations that pin OperationSpec.result_type get OperationEnvelope[YourEnvelope] as their response model; the rest keep the default Any shape (result: any | null on the wire).