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
Overview
Get started
SDKs
CLI
MCPDocs for AI agentsWebhooks
Guides
Platforms
    OverviewKnown issuesLimits and feature requestsFacebookInstagramThreadsLinkedInYouTubeTikTokPinterestBlueskyMastodonX (Twitter)Google BusinessTelegramDiscord
Integrations
Migrate
Plans and billing
GlossaryChangelogAPI reference
Platforms

Limits and feature requests: what OmniSocials cannot do

Some things OmniSocials cannot do. A platform does not allow it (TikTok's API cannot delete a video), OmniSocials has not built it yet (bold text on Telegram), or it works only in the OmniSocials app (connecting an account). The API lists these gaps with the reason and what to do instead, so an agent can answer a person at once instead of guessing. When the person still wants the feature, the agent can send a feature request for them.

Both work with every API key. No scope is needed.

List the limits

GET /limits returns every entry. Filter with platform (an entry for every channel stays in) or area (posts, media, inbox, analytics, automations, accounts, ads, team, other).

TerminalTerminal
curl "https://api.omnisocials.com/v1/limits?platform=tiktok" \ -H "Authorization: Bearer omsk_live_..."
JSON
{ "data": [ { "id": "tiktok.delete", "kind": "platform", "kind_label": "The platform does not allow it", "area": "posts", "platforms": ["tiktok"], "title": "Delete a TikTok video", "says": "TikTok's API cannot delete a video. delete_post removes it from OmniSocials only.", "instead": "Delete the video in the TikTok app.", "requestable": false } ], "kinds": { "platform": "The platform does not allow it", "...": "..." } }
kindMeaningCan be requested
platformThe platform does not allow itNo
by_designOmniSocials does not do this on purpose (for example, reading other people's profiles)No
not_builtOmniSocials has not built it yetYes
betaBuilt, open to some accounts onlyYes
dashboard_onlyWorks in the OmniSocials app, not through the API or MCPYes
needs_setupWorks after a setup step the person takesYes

Tell the person says and instead in your own words. The list changes as features ship, so read it at the time of the question rather than storing it.

Send a feature request

POST /feature-requests stores a request for the person who owns the key. The OmniSocials team reads every request. Send one only when the person asked for it.

TerminalTerminal
curl -X POST "https://api.omnisocials.com/v1/feature-requests" \ -H "Authorization: Bearer omsk_live_..." \ -H "Content-Type: application/json" \ -d '{ "summary": "Post our daily update to the Announcements topic of our Telegram group, not to the whole group.", "limit_id": "telegram.forum_topics" }'
FieldRule
summaryRequired, 10 to 1,000 characters: what the person wants to do and why, in one or two sentences. Never a conversation or other people's personal data.
titleOptional, up to 120 characters. Made from the summary when left out.
platform, areaOptional. Taken from the limit when limit_id is given.
limit_idOptional: the id of the GET /limits entry the request is about.

The answer has an outcome:

  • created (201): a new request.
  • voted (201): the person's organisation already has an open request with the same limit_id. Their vote and their summary are added to it, so requests for one gap add up.
  • already_requested (200): this person already asked for it (the same limit_id, or the same text within a day). Nothing new is stored.

Errors: 400 invalid_summary, invalid_title, invalid_platform, invalid_area, unknown_limit; 409 not_requestable when limit_id is a platform or by_design entry (the entry is in error.limit, nothing is stored); 429 too_many_requests after 10 requests in an hour.

The request is stored with the person's name and email, so the team can answer. The person sees it in OmniSocials under Settings → Request a feature, with requests sent from the app. When the team changes the status (In progress, Done, Declined) or replies, the person gets an email and a notice in the app. People who voted hear it when the request is done.

Read requests back

GET /feature-requests returns the person's own requests (newest first, at most 50), and GET /feature-requests/{id} one request. Each carries status, team_answer, team_replies, votes_count, limit_id and source (app, mcp, api or cli).

From an AI assistant

The MCP server has the same three calls as tools: get_limits, request_feature and list_feature_requests. Its server instructions tell the assistant to read get_limits before it says that something is not possible, to give the reason, and to offer request_feature only after the person agrees. An unsupported_platform, unsupported_reply_type or not_supported error from a tool ends with a line that points to request_feature.

The CLI has limits, feature:request, feature:list and feature:get.

For platform behaviour that makes a post fail, see Known issues.

Last modified on November 4, 2026
Known issuesFacebook
On this page
  • List the limits
  • Send a feature request
  • Read requests back
  • From an AI assistant
JSON