SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Send a small file (under about 700 KB) as base64 text and get a file_id

Send a small file such as a logo or image inline as base64 and get a file_id to use with media[].file_id on POST /posts and PATCH /posts/{id}. Accepted: PNG, JPG or GIF images up to 9 MB; MP4 video up to 450 MB; PDF, Word or PowerPoint up to 90 MB. Request bodies are capped at 1 MB, so files over about 700 KB must use POST /files/upload-links instead. 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.

POSThttps://app.softsolz.uk/api/v1/services/social/files

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.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

file_namestringrequired

File name, e.g. logo.png.

content_base64stringrequired

The file bytes, base64 encoded.

sha256string

Optional hex SHA-256 of the file, to catch a damaged transfer.

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.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/social/files \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"file_name": "pixel.png",
"content_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"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"
}
}