Skip to content

Managing files

Tallyfy’s API lets you upload files (up to 100MB) and attach them to tasks or kick-off forms. You can also download, retrieve metadata for, and delete those files through dedicated endpoints.

Check the individual pages below for request details and code examples.

Files > Upload & attach file

Tallyfy’s API requires a two-step process to attach files to form fields: first upload the file via a multipart POST to the /file endpoint to receive an asset object and then use a PUT request to link that asset object to the specific task or kick-off form field using the correct capture IDs and subject parameters.

Files > Get file metadata

Tallyfy’s API lets you retrieve metadata for any uploaded file (asset) by calling GET on the asset endpoint with your organization and asset IDs and it returns details like the filename and upload date and which process or task the file is attached to.

Files > Download file

Tallyfy’s API provides two GET endpoints for retrieving uploaded files: one that returns the file inline with its original MIME type for browser display and another with a /dl suffix that forces a download as an attachment with the original filename preserved in the Content-Disposition header.

Files > Delete file

Tallyfy’s API lets you permanently delete an uploaded file and its storage record by sending a DELETE request to the /file/ endpoint with your organization and asset IDs — though organization logos are protected from deletion and an alternative /assets/ endpoint only archives without removing the actual stored file.