Upload a media file

POST

https://app.onlysocial.io/os/api/{workspaceUuid}/media/

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "file": "string",
    "alt_text": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.onlysocial.io/os/api/<workspaceUuid>/media/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "file": "string",
    "alt_text": "string"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "id": "1",
    "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
    "name": "blue.png",
    "mime_type": "image/png",
    "type": "image",
    "url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
    "thumb_url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
    "is_video": false,
    "created_at": "2024-03-29 15:33:23"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

Modified at 2025-07-08 08:03:21

Get a media file

Delete a media file