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

Delete a video workspace

Deletes a video workspace and removes its assets from storage. The URLs associated with those assets become inaccessible, so use this operation only when you intend to remove the workspace and its stored assets.

1 parameter
workspace_idstringrequired

The Gumlet workspace ID, available in the dashboard or from the workspace list.

5 status codes
200Returns an empty object after the workspace is deleted.
400Returned when the request is invalid.

One documented failure

  • collection_not_found

    Could not find any video workspace with specified workspace_id.

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 is not found.

One documented failure

  • collection_not_found

    Could not find any video workspace with specified workspace_id.

errorobjectrequired

Error handling

The workspace_id path parameter must identify the workspace to delete. A 404 is returned when the workspace 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.