Skip to content

File handling

Files in UbiOps are called blobs. A blob is any type of file that can be used as input to models and pipelines, or produced as output.

Working with blobs

Blobs are files that are uploaded to UbiOps and that can be used in requests to models and pipelines. A file produced as output in a model or pipeline will be stored as a blob as well, which can be downloaded via the WebApp or API.

Each blob is uniquely identified in a project using its id, an identifier string in UUID format. It is stored on a UbiOps storage system for 72 hours, or a shorter duration if desired by the user, and can be used or downloaded within this timespan. This way one blob can be used in multiple requests, or the output blob of a request can be used as the input of another.

To use blobs in a model, define the model with type structured and create one or more input fields with data type blob.

  • When using the WebApp for making requests, blobs can easily be uploaded using the form when making the request.
  • When using the API, a blob is first uploaded using the blob management endpoints. A request can then be made by passing the unique identifier of the blob as the value for the field.

More information about using blobs via the API can be found on our Swagger API explorer.

See platform limits for limitations on the usage of blobs.

Managing access to blobs

Users and service accounts can be given permissions to blobs on a project level. The following default roles are available:

  • blob-viewer - can list and download blobs.
  • blob-viewer - can list, download and upload blobs.
  • blob-admin - can list, download, upload and delete blobs.

These permissions can only be granted to a user for the entire project, not per individual blob.

Learn more about permissions in UbiOps on Permissions and roles.