Get presigned upload URL

curl --request GET \
  --url https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "expires_in": 3600,
  "max_bytes": 20971520,
  "s3_key": "scanner/photos/2026/04/abc123.jpg",
  "upload_headers": {
    "Content-Type": "image/jpeg"
  },
  "upload_method": "PUT",
  "upload_url": "https://<account>.r2.cloudflarestorage.com/bucket/media/scanner/photos/...jpg?X-Amz-Signature=..."
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

GET

scanner

api

sessions

{session_id}

presigned-upload-url

Get presigned upload URL

curl --request GET \
  --url https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/scanner/api/v1/sessions/{session_id}/presigned-upload-url")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "expires_in": 3600,
  "max_bytes": 20971520,
  "s3_key": "scanner/photos/2026/04/abc123.jpg",
  "upload_headers": {
    "Content-Type": "image/jpeg"
  },
  "upload_method": "PUT",
  "upload_url": "https://<account>.r2.cloudflarestorage.com/bucket/media/scanner/photos/...jpg?X-Amz-Signature=..."
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

{
  "type": "https://closient.com/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "timestamp": "2026-03-31T12:00:00+00:00"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

session_id

string

required

Unique session short_id identifier.

Query Parameters

photo_type

enum<string>

default:other

Photo classification used to namespace the generated S3 key. See PhotoTypeEnum for the full set.

Available options:

front,

back,

left,

right,

top,

bottom,

nutrition,

ingredients,

barcode,

recycling,

certification,

other

original_filename

string

default:photo.jpg

Original filename for extension detection.

Response

Presigned upload URL and metadata.

The client sends the raw image bytes as the request body of a single PUT to upload_url, with exactly the headers in upload_headers. Those headers are part of the signature — changing or omitting one is a 403 from the bucket.

C-5227 replaced a presigned multipart POST (upload_fields) here: Cloudflare R2, which has held media since C-4517, does not implement the S3 POST Object API and answered every such upload with 501 NotImplemented.

upload_url

string

required

Presigned URL to PUT the image bytes to.

upload_method

string

required

HTTP method for the upload request. Always PUT.

Allowed value: "PUT"

upload_headers

Upload Headers · object

required

Headers that must be sent verbatim with the upload; they are signed.

s3_key

string

required

Object key where the file will be stored.

max_bytes

integer

required

Maximum accepted size. Enforced server-side when the upload is registered.

expires_in

integer

required

Seconds until the presigned URL expires.

Overview

Account

Products

Brands

Locations

Retailers

Search

GS1 Digital Link

EPCIS 2.0

Integrations

Billing

Scanner

Compliance

Certifications

Sustainability

Notifications

Dashboard

Analytics

Agent

Substances

BYOS

Content

Signals

Get presigned upload URL

Authorizations

Path Parameters

Query Parameters

Response