OCT-103 Gumlet outreach
POST/video/workspaces/{workspace_id}/remove-assets-from-folder

Remove assets from their folders

Removes one or more assets from their current folder assignment in a video workspace. Supply the asset IDs in asset_ids to remove those assets from their folders; the assets themselves are not described as being deleted.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
workspace_idstringrequired

The ID of the video workspace containing the assets.

The asset IDs to remove from their current folder assignments. asset_ids is required.

asset_idsarray<string>required

An array of asset IDs to remove from their folders.

4 status codes
200Returns an object containing a message and removedCount, the number of assets removed from folder assignments.
messagestringoptional
removedCountintegeroptional
Default:0
400Returned when the request is invalid.

One documented failure

  • assets_not_found

    Some assets were not found or do not belong to this workspace.

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

Error handling

The workspace_id path parameter identifies the workspace containing the assets. The request body must include asset_ids; a 400 indicates a bad request, a 401 indicates missing or invalid authentication, and a 403 indicates an unpaid account or insufficient role permissions.