Resource Delete

[MODE:SIDEEFFECTS] Destructive, idempotent. Tier: base.

Generic delete. Routes to c.<Resource>.Delete* which hits Rails DELETE /api/<plural>/:id. Most resource deletions cascade through dependent: :destroy associations on the Rails side.

When to use

• Cleaning up a Playground after a Trick/Job has finished.
• Removing dead Props after a repo migration.
• Pruning unused Secrets/Webhooks/Templates.

Inputs

Field	Type	Required	Notes
resource	string (enum)	yes	Canonical or alias
id	number	one of	Numeric ID
identifier	string	one of	Numeric ID or slug-safe name (named resources)
confirm	bool	yes (unless --yolo)	Must be true

Output

{
  "resource": "playground",
  "identifier": "my-app",
  "id": 42,
  "deleted": true
}

Behavior — Playground

Rails PlaygroundsController#destroy does NOT block-and-delete. It marks the playground destroying and enqueues PlaygroundDestroyJob. The HTTP 202 returns immediately; physical destruction (Compose down, volumes, networks, etc.) happens async on the Marquee. Use fibe_playgrounds_wait(status:"destroyed") if you need to be sure it's gone.

If the playground is already in destroying, the call is idempotent — no second job is queued.

Behavior — others

Resource	Notes
prop	Cascade-detaches related Playspecs/Templates referencing it; the underlying Git repo is NOT deleted (you handle that separately).
playspec	Refuses if a non-destroyed Playground still references it.
template	Deletes versions; refuses if linked Playspecs still exist. Use template_version to delete a single version.
secret	Plaintext gone forever — irreversible.
webhook	Stops future deliveries; past delivery logs persist.
agent	Stops chats, removes mounts; artefacts/feedbacks/mutters cascade.
template_source	Clears Source attachment from a template (special semantics — alias for "set source to null").
audit_log / memory	Self-delete only; admin-only for cross-player.

Gotchas

• confirm:true is enforced server-side (in the SDK) when not in --yolo. Without it you get a confirmRequiredError and no API call is made.
• Named-identifier deletion of an in-flight Playground may race with destroying transition; you'll see INVALID_STATE if you retry against an already-destroying record.
• Rails returns 202/204 on success; the SDK normalizes to a deleted: true envelope.
• Deletion is not reversible. There is no soft-delete restore for Playgrounds, Props, Secrets.
• secret deletion does NOT remove the Secret from running Playground envs that already mounted it; rolling out a new compose is required to fully evict.

Related

• fibe_resource_get — confirm what you're about to delete.
• fibe_playgrounds_action — stop first if you want graceful shutdown.
• fibe_playgrounds_wait — confirm async destruction.