Create a presigned upload URL

curl --request POST \
  --url https://alpha.api.trycaesar.com/v1/files/presign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>",
  "size": 1
}
'

import requests

url = "https://alpha.api.trycaesar.com/v1/files/presign"

payload = {
    "filename": "<string>",
    "size": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filename: '<string>', size: 1})
};

fetch('https://alpha.api.trycaesar.com/v1/files/presign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "expires_in_seconds": 123,
  "max_object_bytes": 123,
  "name": "<string>",
  "url": "<string>",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

POST

files

presign

Create a presigned upload URL

curl --request POST \
  --url https://alpha.api.trycaesar.com/v1/files/presign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>",
  "size": 1
}
'

import requests

url = "https://alpha.api.trycaesar.com/v1/files/presign"

payload = {
    "filename": "<string>",
    "size": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filename: '<string>', size: 1})
};

fetch('https://alpha.api.trycaesar.com/v1/files/presign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "expires_in_seconds": 123,
  "max_object_bytes": 123,
  "name": "<string>",
  "url": "<string>",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "<string>",
  "type": "error",
  "$schema": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Session-ID

string

Optional client session identifier.

Body

application/json

filename

string

required

Filename to upload. Sanitized server-side; the response echoes the stored name.

Required string length: 1 - 512

size

integer<int64>

required

Exact file size in bytes. The presigned URL binds this length, so the PUT body must match it.

Required range: x >= 0

content_type

string

Optional MIME type recorded on the object.

Maximum string length: 255

Response

Presigned upload URL.

expires_in_seconds

integer<int64>

required

Seconds until the presigned URL expires.

max_object_bytes

integer<int64>

required

Per-file upload size limit in bytes.

name

string

required

Sanitized filename the upload will be stored and listed under.

url

string

required

Presigned S3 PUT URL. Upload the raw file bytes to this URL with an HTTP PUT (no Authorization header); the body must be exactly the declared size.

$schema

string<uri>

read-only

A URL to the JSON Schema for this object.

Example:

"https://alpha.api.trycaesar.com/FilePresignResponse.json"

Record feedback List uploaded files

API reference

Endpoints

Create a presigned upload URL

Authorizations

Headers

Body

Response