Feature requests

Download schema

What OmniSocials cannot do, why, and what to do instead (GET /limits), and feature requests for the person who owns the key. Built for AI agents: read the limits before you tell a person something is not possible, and send a request only after they agree. No scope needed.

List what OmniSocials cannot do

GET

https://api.omnisocials.com/v1

/limits

The things OmniSocials cannot do, why, and what to do instead: platform rules, features not built yet, features that work in the OmniSocials app only. Read it before you tell a person that something is not possible, so you can give the reason. When the person still wants a requestable entry, send a feature request with its limit_id. Works with every key; no scope needed.

List what OmniSocials cannot do › query Parameters

platform

string

Only the entries for this platform (entries for every channel stay in).

area

string · enum

Enum values:

posts

media

inbox

analytics

automations

accounts

ads

team

List what OmniSocials cannot do › Responses

The entries

Limit[]

List your feature requests

GET

https://api.omnisocials.com/v1

/feature-requests

The feature requests of the person who owns the key (sent from the app, the MCP server, the API or the CLI), newest first, at most 50, with their status and the team's replies.

List your feature requests › Responses

200

The requests

FeatureRequest[]

GET/feature-requests

curl "https://api.omnisocials.com/v1/feature-requests" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": [
    {
      "id": 412,
      "title": "Post to a topic of a Telegram group",
      "summary": "Post our daily update to the Announcements topic of our Telegram group.",
      "status": "open",
      "team_answer": "team_answer",
      "team_replies": [
        {
          "message": "message",
          "created_at": "2024-08-25T15:00:00Z"
        }
      ],
      "votes_count": 0,
      "limit_id": "telegram.forum_topics",
      "platform": "platform",
      "area": "area",
      "source": "app",
      "created_at": "2024-08-25T15:00:00Z",
      "updated_at": "2024-08-25T15:00:00Z",
      "completed_at": "2024-08-25T15:00:00Z"
    }
  ]
}

json

application/json

Send a feature request

POST

https://api.omnisocials.com/v1

/feature-requests

Sends a feature request to the OmniSocials team for the person who owns the key (their name and email are stored with it so the team can answer). Send it only when the person asked for it. Write summary yourself: what the person wants to do and why, in one or two sentences; never a conversation. When the request matches an entry of GET /limits, pass its limit_id: a second person of the same organisation then adds a vote to the open request instead of a new one. The person sees the request in OmniSocials (Settings, Request a feature) and gets an email when its status changes. At most 10 requests an hour per person.

Send a feature request › Request Body

summary

string · minLength: 10 · maxLength: 1000 · required

What the person wants to do and why, in one or two sentences.

title

string · maxLength: 120

A short name for the request. Made from the summary when left out.

platform

string

The platform it is about, when it is about one.

area

string · enum

Enum values:

posts

media

inbox

analytics

automations

accounts

ads

team

limit_id

string

The id of the GET /limits entry the request is about.

source

string · enum

Where the request comes from. The MCP servers and the CLI set it; default api.

Enum values:

mcp

api

cli

Send a feature request › Responses

outcome: already_requested: this person already has an open request for it; data is that request.

No data returned

Get a feature request

GET

https://api.omnisocials.com/v1

/feature-requests/{id}

One request of the person or their organisation, with its status and the team's replies.

Get a feature request › path Parameters

id

integer · required

Get a feature request › Responses

The request

FeatureRequest

GET/feature-requests/{id}

curl "https://api.omnisocials.com/v1/feature-requests/412" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": {
    "id": 412,
    "title": "Post to a topic of a Telegram group",
    "summary": "Post our daily update to the Announcements topic of our Telegram group.",
    "status": "open",
    "team_answer": "team_answer",
    "team_replies": [
      {
        "message": "message",
        "created_at": "2024-08-25T15:00:00Z"
      }
    ],
    "votes_count": 0,
    "limit_id": "telegram.forum_topics",
    "platform": "platform",
    "area": "area",
    "source": "app",
    "created_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z",
    "completed_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Automations

List what OmniSocials cannot do

GET

https://api.omnisocials.com/v1

/limits

List what OmniSocials cannot do › query Parameters

platform

string

Only the entries for this platform (entries for every channel stay in).

area

string · enum

Enum values:

posts

media

inbox

analytics

automations

accounts

ads

team

List what OmniSocials cannot do › Responses

The entries

Limit[]

List your feature requests

GET

https://api.omnisocials.com/v1

/feature-requests

The feature requests of the person who owns the key (sent from the app, the MCP server, the API or the CLI), newest first, at most 50, with their status and the team's replies.

List your feature requests › Responses

200

The requests

FeatureRequest[]

Send a feature request

POST

https://api.omnisocials.com/v1

/feature-requests

Send a feature request › Request Body

summary

string · minLength: 10 · maxLength: 1000 · required

What the person wants to do and why, in one or two sentences.

title

string · maxLength: 120

A short name for the request. Made from the summary when left out.

platform

string

The platform it is about, when it is about one.

area

string · enum

Enum values:

posts

media

inbox

analytics

automations

accounts

ads

team

limit_id

string

The id of the GET /limits entry the request is about.

source

string · enum

Where the request comes from. The MCP servers and the CLI set it; default api.

Enum values:

mcp

api

cli

Send a feature request › Responses

outcome: already_requested: this person already has an open request for it; data is that request.

No data returned