Folders

Organize uploaded media into folders — list, create, and delete them to keep large asset libraries manageable.

List folders

GET

/folders

Returns all folders in the workspace as a flat list (build the tree client-side via parent_id). Use folder ids with the media endpoints to organize and find assets.

List folders › Responses

200

List of folders

Folder[]

Create a folder

POST

/folders

Create a folder › Request Body

name

string · required

parent_id

string | null

Parent folder id to nest under, or omit for a top-level folder

Create a folder › Responses

Folder created

Folder

Delete a folder

DELETE

/folders/{id}

Deletes the folder. Its media is NOT deleted - files move to the root ("All media"), and any subfolders move up to this folder's parent.

Delete a folder › path Parameters

id

string · required

Delete a folder › Responses

Folder deleted

No data returned

Rename or move a folder

PATCH

/folders/{id}

Rename or move a folder › path Parameters

id

string · required

Rename or move a folder › Request Body

name

string

parent_id

string | null

New parent folder id, or null to move to the top level

Rename or move a folder › Responses

Folder updated

No data returned

Media Hashtag Sets

OmniSocials API

Folders

Organize uploaded media into folders — list, create, and delete them to keep large asset libraries manageable.

List folders

GET

/folders

Returns all folders in the workspace as a flat list (build the tree client-side via parent_id). Use folder ids with the media endpoints to organize and find assets.

List folders › Responses

200

List of folders

Folder[]

Create a folder

POST

/folders

Create a folder › Request Body

name

string · required

parent_id

string | null

Parent folder id to nest under, or omit for a top-level folder

Create a folder › Responses

Folder created

Folder

Delete a folder

DELETE

/folders/{id}

Deletes the folder. Its media is NOT deleted - files move to the root ("All media"), and any subfolders move up to this folder's parent.

Delete a folder › path Parameters

id

string · required

Delete a folder › Responses

Folder deleted

No data returned

Rename or move a folder

PATCH

/folders/{id}

Rename or move a folder › path Parameters

id

string · required

Rename or move a folder › Request Body

name

string

parent_id

string | null

New parent folder id, or null to move to the top level

Rename or move a folder › Responses

Folder updated

No data returned

Media Hashtag Sets