File upload

Introduction

Uploading a file is a two-step process:

1. Upload the bytes of your files using the upload endpoint. This returns an identifier of uploaded bytes.
2. Use this file identifier to associate it with a compatible item according to the file context.

A file used by an item is flagged as associated. An associated file cannot be reused on another item. Unassociated files will be deleted after a few days by a garbage collector process.

Each item requires a specific file context. The compatible context is indicated in the item endpoint documentation.

Contexts

The context is mandatory for an item, and contains the specifications of the file, along with the thumbnail formats available for this item.

Formats