Create a File
Add a new file to a silo entry without an explicit UUID. The file data can be provided inline as base64 encoded data, or omitted to create a placeholder. When data is not provided, you must provide sha256, size, and mime fields, and the response will include a url field that can be used to stream/upload the file contents directly via a PUT request to that URL. For non enrolled users, only the format and attachment categories are allowed.
Authorizations
Use the Bearer scheme with a valid JWT token to authenticate requests. Example: Authorization: Bearer <token>
Path Parameters
UUID of the silo entry.
Body
Name of the file.
"invoice.pdf"
Category of the file.
"format"
Base64 encoded binary data. Optional - if not provided, sha256, size, and mime are required.
Description of the file.
"Invoice for January 2021."
When true, this file may be embedded inside other files, like PDFs. Default is false.
true
Key used to identify the file in the entry.
"pdf"
Any additional meta data about the file.
MIME type of the file. Required when data is not provided.
"application/pdf"
When true, this file is private and can only be accessed by the owner. Default is false.
true
SHA256 hex hash of the file. Required when data is not provided.
"27a0b656df99dc32124b4c49f2f3c35025f0a7453f289cbaa0701435cfcf4e28"
Size of the file in bytes. Required when data is not provided.
12345
Response
OK
Category of the file.
"version"
The date and time this file was created.
"2018-01-01T00:00:00.000Z"
Description of the file.
"Invoice for January 2021."
When true, the file can be embedded inside another file, like a PDF.
true
The UUID of the entry this file belongs to.
"347c5b04-cde2-11ed-afa1-0242ac120002"
SHA256 hash of the file.
"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6"
The UUID that identifies the file in the entry.
Key used to identify the file by the service or app that generated it.
"pdf"
Any additional meta data about the file.
MIME type of the file.
"application/pdf"
Name of the file.
"invoice.pdf"
Set of previous versions of the file.
When true, the file will not have a public link.
Size of the file in bytes.
12345
When true, indicates that the file's contents have been uploaded successfully.
true
URL where the file's contents can be downloaded.