Skip to content
Press.js Press.js Press.js Docs

Upload a single CAS blob for an upload session

PUT
/v1/upload-sessions/{uploadSessionId}/blobs/{sha256}
 
curl --request PUT \
  --url https://api.presscloud.example/v1/upload-sessions/example/blobs/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --header 'X-Upload-Token: example' \
  --data binary

Uploads one raw file blob addressed by sha256 and stores it in CAS if it is referenced by the upload session.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
uploadSessionId
required
string
>= 1 characters
sha256
required
string
>= 1 characters

Header Parameters

Section titled “Header Parameters ”
X-Upload-Token
required
string
>= 1 characters

Opaque session token returned when the upload session is created.

Request Body required

Section titled “Request Body required ”
Media type application/octet-stream
string format: binary

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Blob uploaded or confirmed present.

Media type application/json
object
uploadSessionId
required
string
alreadyPresent
required
boolean
blob
required
object
sha256
required
string
>= 1 characters
size
required
integer
mime
string
r2Key
required
string
>= 1 characters
Example generated
{
  "uploadSessionId": "example",
  "alreadyPresent": true,
  "blob": {
    "sha256": "example",
    "size": 1,
    "mime": "example",
    "r2Key": "example"
  }
}

400

Section titled “400 ”

Invalid request payload or parameters.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}

401

Section titled “401 ”

Authentication material for the operation is missing.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}

403

Section titled “403 ”

The caller is not permitted to perform the operation.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}

404

Section titled “404 ”

Requested resource was not found.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}

409

Section titled “409 ”

Requested operation conflicts with the current resource state.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}

410

Section titled “410 ”

The requested resource is no longer available.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}