OmniSocialsOmniSocials
DocumentationAPI reference
Help centerSupport
  • Documentation
  • API reference
Developers
  • Quickstart
  • API reference
  • SDKs
  • MCP server
  • CLI
For AI agents
  • Docs for AI agents
  • llms.txt
  • OpenAPI spec
  • Postman collection
Product
  • OmniSocials
  • Pricing
  • Changelog
  • Help center
Company
  • Support
  • Privacy policy
  • Terms of service

© 2026 OmniSocials

OmniSocials on GitHubOmniSocials on XOmniSocials on LinkedIn
Information
Posts
    List postsgetList live platform postsgetGet a postgetDelete a postdeleteUpdate a postpatchCreate a postpostCreate and publish postpostPublish a post nowpostRetry failed postpostApprove a postpostReject a postpostGet approval reviewget
Media
    List mediagetGet a media itemgetDelete a media itemdeleteRename or move mediapatchUpload a filepostUpload from base64postUpload from a URLpostCreate an upload URLpostSplit a PDF into pagespostCheck media limitspostUpload with a tokenpost
Folders
    List foldersgetCreate a folderpostDelete a folderdeleteRename or move a folderpatch
Hashtag Sets
    List hashtag setsgetCreate a hashtag setpostGet a hashtag setgetDelete a hashtag setdeleteUpdate a hashtag setpatch
Accounts
    List accountsgetGet an accountget
Analytics
    Get bulk post analyticsgetGet post analyticsgetGet analytics overviewgetGet account analyticsgetGet best posting timesget
Approvals
    List approval workflowsget
Webhooks
    List webhooksgetCreate a webhookpostGet a webhookgetDelete a webhookdeleteUpdate a webhookpatchRotate webhook secretpost
Locations
    Search locationsgetValidate a locationget
Audio
    Search Instagram audioget
Pinterest
    List product PinsgetCheck a product Pinget
Inbox
    List conversationsgetList messagesgetMark conversation readpostReply to a conversationpostHide or unhide a commentpostDelete a commentdeleteGet next conversationget
Automations
    List automationsgetCreate an automationpostGet an automationgetDelete an automationdeleteUpdate an automationpatchList automation eventsget
Schemas
OmniSocials API
OmniSocials API

Folders

Download schema

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


List folders

GET
https://api.omnisocials.com/v1
/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[]
GET/folders
curl "https://api.omnisocials.com/v1/folders" \ -H "Authorization: Bearer $OMNISOCIALS_API_KEY"
Example Responses
{ "data": [ { "id": "id", "name": "name", "parent_id": "parent_id", "item_count": 0, "created_at": "2024-08-25T15:00:00Z" } ] }
json
application/json

Create a folder

POST
https://api.omnisocials.com/v1
/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
POST/folders
curl -X POST "https://api.omnisocials.com/v1/folders" \ -H "Authorization: Bearer $OMNISOCIALS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Campaigns"}'
Example Request Body
{ "name": "name", "parent_id": "parent_id" }
json
Example Responses
{ "data": { "id": "id", "name": "name", "parent_id": "parent_id", "item_count": 0, "created_at": "2024-08-25T15:00:00Z" } }
json
application/json

Delete a folder

DELETE
https://api.omnisocials.com/v1
/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
DELETE/folders/{id}
curl -X DELETE "https://api.omnisocials.com/v1/folders/42" \ -H "Authorization: Bearer $OMNISOCIALS_API_KEY"
Example Responses
No example specified for this content type

Rename or move a folder

PATCH
https://api.omnisocials.com/v1
/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
PATCH/folders/{id}
curl -X PATCH "https://api.omnisocials.com/v1/folders/42" \ -H "Authorization: Bearer $OMNISOCIALS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Campaigns 2026"}'
Example Request Body
{ "name": "name", "parent_id": "parent_id" }
json
Example Responses
No example specified for this content type

MediaHashtag Sets