Delete a Folder

Delete a folder. By default, only empty folders can be deleted; pass ?recursive=true to delete a folder along with all of its subfolders and files. System folders cannot be deleted.

Requires a user-scoped API key (u:gcai_...).

DELETE /folders/{id}

Delete a folder

cURL

curl --request DELETE \
  --url https://app.gc.ai/api/external/v1/folders/{id} \
  --header 'Authorization: <api-key>'

400

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization · string · header · required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Path Parameters

id · string<uuid> · required

The folder ID

Query Parameters

recursive · enum<string>

When true, recursively delete subfolders and files. Defaults to false.

Available options: true, false

Example:

"true"

Response

204

Folder deleted successfully