Skip to content

Soft-delete a team

DELETE
/teams/{id}

Marks the team deleted_at; preserves closure rows for historic audit. Cascading sweeps fire (ACL rows referencing the team go via the 00017 trigger; user_roles rows go via the FK CASCADE) only when the row is hard-deleted via admin action, not via soft delete.

id
required
string format: uuid

Deleted

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed