Compute

Delete Compute Instance

Changed on

Deletes a specific compute instance by its ID. This action is irreversible.

Requirements:

  • Requires compute permissions (extra_permissions.compute = true)
  • Instance must belong to the authenticated user's workspace

Key Features:

  • Permanently remove compute instances
  • Free up compute resources
  • Stop billing for the instance
  • Clean up unused resources

Important:

  • This action cannot be undone
  • All data on the instance will be lost
  • Instance will be immediately terminated
  • Billing stops after deletion

Common Use Cases:

  • Clean up completed workloads
  • Remove failed or stuck instances
  • Manage compute costs
  • Free up quota for new instances

See fal.ai docs for more details.

Required permissions: compute:instances:write. Key presets that include them: COMPUTE, FULL. See key permissions.

delete/compute/instances/{id}

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/compute/instances/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required

Unique identifier for the compute instance

Example:inst_abc123xyz

Response

Compute instance deleted successfully

Changes

    • info

      the endpoint scheme security computeApiKey was added to the API

    • info

      the endpoint scheme security adminApiKey was removed from the API