OCT-103 Gumlet outreach
DELETE/video/workspaces/{workspace_id}/folders/{folder_id}

Delete a folder

Deletes a folder from a video workspace. Deleting a folder also deletes its descendant folders and the assets inside them through the backend workflow, so check the folder contents before proceeding.

2 parameters
workspace_idstringrequired

The ID of the video workspace containing the folder.

folder_idstringrequired

The ID of the folder to delete.

5 status codes
200Returns an object containing a message confirming the folder deletion.
messagestringoptional
400Returned when the request is invalid.

One documented failure

  • invalid_folder_id

    Folder ID is invalid.

errorobjectrequired
401Returned when the API key or bearer token is missing or invalid.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account is unpaid or the authenticated user lacks sufficient role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired
404Returned when the workspace or folder is not found.

One documented failure

  • folder_not_found

    Folder not found.

errorobjectrequired

Error handling

The workspace_id path parameter identifies the workspace, and the folder_id path parameter identifies the folder to delete. A 404 is returned when the requested resource is not found; a 400 indicates a bad request, a 401 indicates missing or invalid authentication, and a 403 indicates an unpaid account or insufficient role permissions.