API referenceWorkspaceFiles and delivery
Discard file upload
Discards a prepared or failed upload that has not been consumed.
- Endpoint
DELETE /v1/uploads/{fileRef}- Authorization
- The file's stored purpose determines the required permission: `organization_logo` → `settings:update`, `tax_profile_pdf` → `customers:manage`.
- Environments
- Production only
- Idempotency
- Required for safe retries.
Prepare file upload POST
Creates short-lived PUT instructions bound to one organization-owned fileRef. Upload the bytes to upload.url with the declared headers, then pass only fileRef to the consuming operation.
List contacts GET
Lists customers or suppliers, selected by the required kind query parameter.