Media

Media assets are images and videos stored in your Oktopost Media Library that can be attached to posts and messages. The Media Library centralizes all visual content shared through the platform, making it easy to reuse assets across multiple posts and campaigns. Use these endpoints to upload new media, retrieve asset details, browse your library, and manage your visual content.

Media assets uploaded to your library can be reused across multiple posts and messages, eliminating the need to re-upload the same image or video for different social profiles or campaigns.

Get Media

Get single media object by Id.

Example Request

curl -i https://api.oktopost.com/v2/media/026000000000000

Example Result

{  
    "Result": true,
    "Media": {  
        "Id":"026000000000000",
        "Created":"2015-07-22 10:44:21",
        "Modified":"2015-07-22 10:44:21",
        "AccountId":"001000000000000",
        "Status":"valid",
        "CreatedBy":"00A000000000000",
        "ModifiedBy":"00A000000000000",
        "Type":"ImageUrl",
        "Size":0,
        "Resource":"http:\/\/ww1.prweb.com\/prfiles\/2013\/08\/30\/11077903\/India%20Water%20Pumps%20Market.JPG",
        "Name":"http:\/\/ww1.prweb.com\/prfiles\/2013\/08\/30\/11077903\/India%20Water%2",
        "Description":""
    }
}

List Media

List account media assets.

Example Request

curl -i https://api.oktopost.com/v2/media

Example Result

{  
    "Result":true,
    "Items":[  
        {
            "Id": "026000000000000",
            "AccountId": "001000000000000",
            "Status": "valid",
            "Created": "2019-09-22 14:58:12",
            "Modified": "2019-09-22 14:58:12",
            "CreatedBy": "00A000000000000",
            "ModifiedBy": "00A000000000000",
            "Type": "Image",
            "Size": "147068",
            "Resource": "https://s3.amazonaws.com/com-oktopost-app-message-pictures/e4cda957-c14d-4914-ae60-86a4043ae055/Londonteamoutofoffice.jpeg",
            "Name": "London team out of office.jpeg",
            "Description": "",
            "MimeType": "image/jpeg",
            "VideoId": null,
            "VideoPreview": null
        },
        ...
    ],
    "Total":696
}

Parameters

Param	Description
q	The file name that you want to search for.
type	Image, Video or ImageUrl

Create Media

Create a new media asset. Resource must consist of a valid image URL that can be publicly accessed. On success, this endpoint will return a similar response to the GET endpoint.

Example Request

curl -i https://api.oktopost.com/v2/media -X POST \
    -d resource="https://www.oktopost.com/assets/img/oktopost-og.png"

Delete Media

Delete asset from media library.

Example Request

curl -i https://api.oktopost.com/v2/media/026000000000000 -X DELETE

On this page