API referenceWorkspaceFiles and delivery
Prepare file upload
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.
- Endpoint
POST /v1/uploads- Authorization
- Permission depends on the body `purpose`: `organization_logo` → `settings:update`, `tax_profile_pdf` → `customers:manage`.
- Environments
- Production only
- Idempotency
- Required for safe retries.
Upload certificate PUT
Configures an organization CSD or e.firma certificate. Send the certificate and private-key bytes as base64 plus the private-key password. The certificate RFC must match the organization fiscal identity.
Discard file upload DELETE
Discards a prepared or failed upload that has not been consumed.