Get a presigned upload URL

Endpoint to Get a presigned upload URL for a media record on toolzz analytics

POST /api/public/media

Get a presigned upload URL

cURL

curl --request POST \
  --url https://api.example.com/api/public/media

200

{
  "mediaId": "<string>",
  "contentType": "<string>",
  "contentLength": 123,
  "uploadedAt": {},
  "url": "<string>",
  "urlExpiry": "<string>"
}

Show Request

traceId · string · required

The trace ID associated with the media record.

observationId · string

The observation ID associated with the media record. Null if directly associated with a trace.

contentType · enum · required

The MIME type of the media record (e.g., image/png, application/json).

contentLength · integer · required

The size of the media record in bytes.

sha256Hash · string · required

The SHA-256 hash of the media record.

field · string · required

The trace/observation field associated with the media record (e.g., input, output, metadata).

Response Description

Below you will see the description of the Get presigned upload URL response

mediaId · string · required

Unique identifier for the media.

contentType · string · required

MIME type of the media (e.g., “image/png”, “application/pdf”).

contentLength · integer · required

Size of the media in bytes.

uploadedAt · date-time · required

Timestamp indicating when the media was uploaded.

url · string · required

URL to access the media.

urlExpiry · string · required

Expiry information for the media URL.

Code Response

Exemples of Response Code

200

Request Successful Response

400

Request Failure