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 cover_image_file_id, og_image_file_id or <img src="file:<file_id>"> in body_html on POST /posts and PATCH /posts/{id}. Accepted: PNG, JPG, GIF, WebP or AVIF images up to 10 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.
https://app.softsolz.uk/api/v1/services/blogs/files/upload-linksRecent Requests
Kept only in this browserHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
file_namestringrequiredFile name, e.g. deck.pptx.
size_bytesintegerrequiredExact size of the file in bytes.
sha256stringrequiredHex 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/blogs/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" }}