Detach a File from an Entity

Remove a file↔entity link without deleting the file.

DELETE /files/{file_id}/attach

Detach File

cURL

curl --request DELETE \
  --url https://api.example.com/files/{file_id}/attach \
  --header 'Authorization: Bearer <token>'

200

{}

Removes the file_attachments row without deleting the file itself. Idempotent — succeeds even if no matching link exists. entity_type is the same free-form value used when attaching (in practice one of deal, account, contact, task, or project).

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

Field	Type	Description
detached	boolean	Always true.

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 detach.

Query Parameters

entity_type · string · required

CRM entity kind of the link to remove, e.g. deal, account, contact, task, or project.

entity_id · string · required

UUID of the entity to unlink the file from.

Response

200

application/json

Successful Response

{key} · boolean