Overview
Important Notes
Uploaded objects are deleted after 4 days by retention policy.
Endpoint Overview
Below is a list of all the endpoints:
| Method | Endpoint | Function |
|---|---|---|
| POST | /objects/initialization |
Initialize a multipart upload for a new object |
| PUT | /objects/{key}/stream |
Stream an entire object to multipart upload |
| PUT | /objects/{key}/part |
Upload a part of an object to a multipart upload |
| POST | /objects/{key}/completion |
Finish an already initialized multipart upload |
| POST | /objects/{key}/cancellation |
Cancel a multipart upload |
| GET | /objects/{key} |
Download an object |
| DELETE | /objects/{key} |
Delete an object |
| PUT | /objects/{key}/downloaded |
Acknowledge that the object was downloaded and stored |
| GET | /objects/{key}/download-status |
Check download statuses for all receivers |
| GET | /objects/{key}/metadata |
Get the metadata for an object |
General Flow
---
title: General flow
---
sequenceDiagram
autonumber
actor A as Sender
participant DEFT as DEFT REST API
actor B as Receiver
A ->> DEFT: Uploads object
DEFT ->> A: Returns URL and key
A ->> B : Sends URL and/or key to receiver(s)
B ->> DEFT: Downloads object
B ->> DEFT: Acknowledges download
DEFT ->> DEFT: Deletes object when all receiver(s) have downloaded