Hanzo
OpenapiTeam

Removes one blob from a workspace's file store.

Removes one blob from a workspace's file store.

DELETE /v1/team/files/{workspace}/{filename}

Addresshttps://api.hanzo.ai/v1/team/files/{workspace}/{filename}
MethodDELETE
Operationdelete_team_files_by_workspace_by_filename
AuthAuthorization: Bearer $HANZO_API_KEY

Removes one blob from a workspace's file store. The caller must hold a verified session AND be a member of the workspace; anything else — an unknown workspace, another tenant's workspace, a workspace the caller is not in — answers the same 404, so a probe learns nothing about what exists.

It is IDEMPOTENT: deleting a present or an absent blob both answer 204, so a delete never confirms a blob's existence and a foreign blob id (a physical key the caller can never name into another tenant's box) is a harmless no-op. A storage backend that is unavailable fails closed with 502 rather than lying about success.

Request

3 fields.

FieldInTypeRequiredDescription
workspacepathstringyesWorkspace is the workspace uuid the blob belongs to, from the path.
filenamepathstringyesFilename is the last path segment, which the front sets to the blob id when it sends no explicit file.
filequerystringFile is the blob id, and wins over the path segment when both are present.

Response

StatusBodyMeaning
204no content

Failure carries the platform error shape — see Errors.

Examples

hanzo team files workspace rm <workspace> <filename>

Team API · All Hanzo APIs · Interactive reference

How is this guide?

On this page