Folders

Folders let you organize assets in your Media Library into a hierarchy. Each folder can contain media assets and nested sub-folders. Folder IDs use the 035 prefix.

Managing folders requires the Media Library permission on your API key.

List Folders

List folders within the Media Library. By default the response returns top-level folders; use folderId to list children of a specific parent folder.

Parameters

Param	Default	Description
folderId	-	Parent folder ID. When provided, only direct children of that folder are returned.
q	-	Search folders by name.
_page	0	Page number (zero-based). The API computes the offset as `_page × _count`.
_count	12	Number of results per page (max 100).
orderBy	-	Field to sort by.
orderDir	-	Sort direction: `asc` or `desc`.

Example Request

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

Example Result

{
    "Result": true,
    "Items": [
        {
            "Id": "035000000000001",
            "Name": "Product Screenshots",
            "FolderId": null,
            "Created": "2026-01-15 09:30:00"
        },
        {
            "Id": "035000000000002",
            "Name": "Blog Images",
            "FolderId": null,
            "Created": "2026-02-10 14:22:35"
        }
    ],
    "Total": 2
}

Get Folder

Get a single folder by ID.

Example Request

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

Example Result

{
    "Result": true,
    "Folder": {
        "Id": "035000000000001",
        "Name": "Product Screenshots",
        "FolderId": null,
        "Created": "2026-01-15 09:30:00"
    }
}

Create Folder

Create a new folder.

Parameters

Field	Required	Description
name	Yes	Folder name (max 64 characters).
folderId	No	Parent folder ID. Omit or leave empty to create a root-level folder.

Example Request

curl -i https://api.oktopost.com/v2/media-folder -X POST \
    -d name="Campaign Assets" \
    -d folderId="035000000000001"

Example Result

{
    "Result": true,
    "Folder": {
        "Id": "035000000000003",
        "Name": "Campaign Assets",
        "FolderId": "035000000000001",
        "Created": "2026-04-29 12:00:00"
    }
}

Rename Folder

Rename an existing folder.

Parameters

Field	Required	Description
name	Yes	New folder name (max 64 characters).

Example Request

curl -i https://api.oktopost.com/v2/media-folder/035000000000001 -X POST \
    -d name="Product Images"

Example Result

{
    "Result": true,
    "Folder": {
        "Id": "035000000000001",
        "Name": "Product Images",
        "FolderId": null,
        "Created": "2026-01-15 09:30:00"
    }
}

Delete Folder

Delete a folder. Deleting a folder also removes its child folders and the media assets they contain.

Example Request

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

Example Result

{
    "Result": true
}

To list media assets inside a specific folder, use the folderId parameter on the List Media endpoint.

On this page