Documents (LP Classic)

This documentation is for LiquidPlanner Classic: app.liquidplanner.com

Uploading Documents

📘

This action is an exception to the general rule that submitted data should be JSON-encoded; multipart/form-data supports a binary encoding, and is therefore more efficient on both network and CPU than submitting the attached_file as e.g. a Base64 encoded string in JSON.

To create a new document, do a multipart/form-data POST with parameters:

ParameterDescription
document[file_name]name of the file, to be used in download links
document[description]description of the file
document[attached_file]file data (as from a file upload control in an HTML form)

An example, assuming you have a file ‘requirements.xls’ to upload:

% curl https://app.liquidplanner.com/api/v1/workspaces/:id/tasks/:id/documents \
       -F 'document[attached_file][email protected]'                      \
       -F 'document[file_name]=requirements.xls'

Downloading Documents

To download an existing document, do a GET with ‘download’ or ‘thumbnail’ appended, like:

% curl https://app.liquidplanner.com/api/v1/workspaces/:id/tasks/:id/documents/:id/download
% curl https://app.liquidplanner.com/api/v1/workspaces/:id/tasks/:id/documents/:id/thumbnail

You can also attach links to Box, DropBox, and Google Drive documents using a json POST with a document parameter:

It contains the following options:

OptionDescription
typeone of "box", "dropbox", or "google drive"
browse_urlthe url given by Box, Dropbox, or Google Drive as the shareable url for the document
file_namename of the file, to be used in download links
descriptiondescription of the file (optional)
icon_urllink to the image preview which is supplied by Dropbox (applies only to, and is required by, Dropbox attachments)

For example:

% curl https://app.liquidplanner.com/api/v1/workspaces/:id/tasks/:id/documents \
       -d '{ "document": { "browse_url": "https://box.com/link/to/file", "file_name": "FileName.doc", "description": "A description", "type" : "box"  } }'