Skip to main content
POST
Generate Signed Url

Authorizations

Authorization
string
header
required

A floo_ API key.

Headers

X-Floo-Org-Id
string<uuid>

Organization to act in; defaults to the one joined most recently.

Path Parameters

app_id
string<uuid>
required
service_id
string<uuid>
required

Query Parameters

env
string
default:dev
Pattern: ^(dev|prod|preview)$
preview
string | null

Body

application/json

Request body for generating a signed URL.

object_path
string
required

Object path within the bucket (1-1024 characters; no leading slash, backslash, control characters, or empty, '.' or '..' segments). PUT/POST paths must start with 'uploads/'.

Required string length: 1 - 1024
method
enum<string>
default:GET

Access method. GET returns a signed URL; PUT/POST returns a signed POST upload policy.

Available options:
GET,
PUT,
POST
expiration_seconds
integer
default:900

Expiration in seconds (60-3600 for GET; 60-900 for PUT/POST). Default: 900.

Required range: 60 <= x <= 3600
content_type
string | null

Required for PUT/POST; at most 255 characters and no control characters.

Maximum string length: 255
max_bytes
integer | null

Only valid for PUT/POST upload policies; 1-104857600 bytes (100 MiB). Defaults to 10485760 bytes (10 MiB).

Required range: 1 <= x <= 104857600

Response

Successful Response

Response for a generated signed URL.

url
string
required
Minimum string length: 1
method
enum<string>
required
Available options:
GET,
POST
expires_in_seconds
integer
required
Required range: x >= 0
object_path
string
required
Minimum string length: 1
bucket
string
required
Minimum string length: 1
fields
Fields · object | null
max_bytes
integer | null
Required range: x >= 1