Skip to main content
DELETE
Delete File
Soft-delete — sets archived_at. The S3 object is retained; there is no endpoint that removes it. The only hard delete in the Files API is Abort an Upload, which only works while the file is still pending.

Auth

Requires a CRM manage scope and an active organization on the token. Any *:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.

Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

file_id
string
required

UUID of the file to soft-delete.

Response

Successful Response

{key}
boolean