sandboxes

Set or clear a sandbox snapshot's self-cleaning expiry [rate class: sandbox_api_rps]

Set or clear a sandbox snapshot's self-cleaning expiry. expires_after is a duration from NOW ("24h", "7d"; minimum 1h) - at that instant the snapshot deletes itself exactly like delete_sandbox_snapshot (live forks keep running; new forks stop; stored and cold billing stop) - or "never" to cancel a pending expiry. This is YOUR timer: snapshots never expire unless you schedule it. Typical use: expire a fork base a day after the fan-out so it stops counting against storage. get_sandbox_stats shows each snapshot's expires_at.

post/preview/sandboxes/snapshots/{id}/expiry

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/sandboxes/snapshots/{id}/expiry
  • Auth: HTTP bearer

Path parameters

idstring required

The snapshot whose timer to set (get_sandbox_stats lists yours).

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

expires_afterstring required

A duration from now ("24h", "7d"; minimum 1h), or "never" to cancel a pending expiry.

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.