SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Create a one-time upload link for a file of any accepted size

Declare the file (name, exact size in bytes and hex SHA-256) and get a file_id plus a one-time upload_url. Then send the exact bytes with an HTTP PUT to upload_url, for example: curl -T "<file>" "<upload_url>". The link works for 15 minutes, only once, and only for a file with exactly this size and SHA-256. The PUT reply, or GET /files/{file_id}, says ready or why the file was refused. Then use the file_id with file_ids on POST /projects/{id}/assets. Accepted: PNG, JPG, GIF, WebP, ICO images or PDF up to 5 MB. The real file type is read from its bytes, never from the name. Programs, SVG images, old .doc/.ppt/.xls files, Office files with macros, embedded objects or outside links, and PDFs with scripts are refused. A file is kept for 24 hours and can only be used by the same API key or connected app, with this service. Treat upload_url and upload_token as secrets.

POSThttps://app.softsolz.uk/api/v1/services/site-builder/files/upload-links

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

file_namestringrequired

File name, e.g. deck.pptx.

size_bytesintegerrequired

Exact size of the file in bytes.

sha256stringrequired

Hex SHA-256 of the file (64 characters).

Response

Response Body

file_idstringPass this id to the service to use the file.
statusstringready means the file passed every check and can be used.
file_namestringCleaned file name.
kindstring | nullWhat the file turned out to be, read from its bytes.
mimestring | nullMedia type read from the bytes.
size_bytesintegerSize in bytes.
sha256string | nullHex SHA-256 of the file.
reject_codestring | nullWhy the file was refused, when status is rejected.
expires_atstring | nullWhen the file (or, before upload, the link) stops working.
created_atstringWhen it was created.
upload_urlstringOne-time address to PUT the file bytes to. Secret; expires in 15 minutes.
upload_tokenstringThe secret part of upload_url.
upload_methodstringAlways PUT.
how_to_sendstringA ready-to-run command for sending the file.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/site-builder/files/upload-links \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"file_name": "pixel.png",
"size_bytes": 70,
"sha256": "6b7fa434f92a8b80aab02d9bf1a12e49ffcae424e4013a1c4f68b67e3d2bbcd0"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
"data": {
"file_id": "f0000000-0000-0000-0000-000000000001",
"status": "ready",
"file_name": "launch-deck.pptx",
"kind": "document",
"mime": "your-mime",
"size_bytes": 482133,
"sha256": "your-sha256",
"reject_code": null,
"expires_at": "2026-01-01T09:00:00.000Z",
"created_at": "2026-01-01T09:00:00.000Z",
"upload_url": "https://example.com",
"upload_token": "your-upload-token",
"upload_method": "PUT",
"how_to_send": "your-how-to-send"
}
}