Delete a folder
DELETE/
Deletes a folder. What was in it moves up one level; nothing else is deleted.
Needs an API token with the Write permission for workflows (workflow:write).
Parameters
Path
idRequired · UUIDThe folder’s ID.
What moves
In one step, the folders and workflows inside it move to the folder’s own parent, or to the top level if it had none. No workflow is deleted or left without a place. A folder whose name is taken in its new place is renamed Name (2), (3) and so on.
Responses
- 200OK
Deleted, and its contents moved up.
The ID isn’t a UUID.
- 403
FORBIDDENThe token lacks the Write permission for workflows.
- 404
NOT_FOUNDNo folder with this ID in the workspace.
Nothing was deleted. Try again.
Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 403 ACCOUNT_SUSPENDED · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.
Request
GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…" # needs Write for workflows
FOLDER_ID="your-folder-id"
curl -X DELETE "$GORUNNER/api/folders/$FOLDER_ID" \
-H "Authorization: Bearer $GORUNNER_TOKEN"const GORUNNER = "https://api.gorunner.io";
const TOKEN = process.env.GORUNNER_TOKEN;
const FOLDER_ID = process.env.FOLDER_ID;
const res = await fetch(
`${GORUNNER}/api/folders/${FOLDER_ID}`,
{
method: "DELETE",
headers: { Authorization: `Bearer ${TOKEN}` },
},
);
const { data } = await res.json();import os, requests
GORUNNER = "https://api.gorunner.io"
TOKEN = os.environ["GORUNNER_TOKEN"]
FOLDER_ID = os.environ["FOLDER_ID"]
res = requests.delete(
f"{GORUNNER}/api/folders/{FOLDER_ID}",
headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()["data"]Response · 200 OK
{
"data": {
"id": "7a2c9e41-5b3d-4f08-a6e1-2d9c4b7f0e13",
"deleted": true
}
}Every field
It takes no body.
Response · 200 OK
dataobjectBare acknowledgement returned by folder update and delete. It does NOT contain the folder — re-list if you need the new state.
idUUIDThe folder the operation applied to.
updatedbooleanAlways true; present on the update response only.
deletedbooleanAlways true; present on the delete response only.