Salesly API
API Reference

Delete a document

**Irreversible.** Unlike contacts and opportunities, documents are not soft-deleted: the record, every contact/opportunity/order link, and the stored file are all removed. To remove a document from one parent while keeping the file, use the unlink/detach endpoints instead.

DELETE
/documents/{id}

Authorization

x-api-key<token>

Your tenant API key

In: header

Path Parameters

id
Required
integer
curl -X DELETE "https://rest.salesly.app/api/v1/developers/documents/0" \
  -H "x-api-key: <token>"

Document deleted

{
  "deleted": true
}

Get a download URL for a document

Returns a short-lived pre-signed `download_url` for the stored file, valid for 300 seconds. Fetch that URL directly — it needs no authentication and must be requested **without** your `x-api-key` header. Treat `download_url` as a short-lived credential: anyone holding it can read the file until it expires, and it cannot be revoked. Do not log, cache or forward it. Request a fresh URL for each download. On deployments whose storage backend cannot sign URLs, this endpoint streams the file directly instead, as `application/octet-stream` with a `Content-Disposition: attachment` header.

List a contact's documents

Returns documents linked to the contact. By default only documents linked directly to the contact are returned; pass `scope=all` to also include documents attached to the contact's opportunities and orders.