Delete a folder, re-parenting its contents
Requires scope
workflow:writeDeletes the folder. NOTHING inside it is deleted: in one transaction its child FOLDERS and the WORKFLOWS filed in it are re-parented to this folder's own parent (to the root, if it was a root folder). Deleting a folder therefore never cascades and never orphans a workflow.
The response is only an acknowledgement {id, deleted: true}.
Authorization
bearerAuth AuthorizationBearer <token>
An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
id*string
The folder's UUID.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/folders/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7081", "deleted": true }}