> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Generate Social Selling comment suggestions > Write AI comment suggestions for a LinkedIn post, each one from a different identity of your team, in that identity’s voice (job title, seniority, interests) and in the language of the post. Pass exactly one post source: `postId` (a tracked post id from the Social Selling posts list), `publishingPostId` (a publishing post id, e.g. the `publishingPostId` of a tracked post) or `postContent` (the text of any post). Users restricted to specific identities only reach posts of their own identities through `postId` / `publishingPostId` (404 otherwise, a tracked third-party post included); pass any other post’s text as `postContent`. Choose the writers with `identityIds`, or omit it and the AI picks the most relevant identities you may use, never the post’s own author. Tune `tone`, `length`, `useEmojis` and `count` (1–6, default 3). Generation takes up to 60 seconds. Read-only: nothing is posted, scheduled or stored. To publish a suggestion, call `add_a_comment_to_a_social_selling_post` with the same `postId` or `publishingPostId`, the suggestion’s `identityId`, and its `commentText` as `text`. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 10 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json post /v1/social-selling/comment-suggestions openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/social-selling/comment-suggestions: post: tags: - Social Selling summary: Generate Social Selling comment suggestions description: >- Write AI comment suggestions for a LinkedIn post, each one from a different identity of your team, in that identity’s voice (job title, seniority, interests) and in the language of the post. Pass exactly one post source: `postId` (a tracked post id from the Social Selling posts list), `publishingPostId` (a publishing post id, e.g. the `publishingPostId` of a tracked post) or `postContent` (the text of any post). Users restricted to specific identities only reach posts of their own identities through `postId` / `publishingPostId` (404 otherwise, a tracked third-party post included); pass any other post’s text as `postContent`. Choose the writers with `identityIds`, or omit it and the AI picks the most relevant identities you may use, never the post’s own author. Tune `tone`, `length`, `useEmojis` and `count` (1–6, default 3). Generation takes up to 60 seconds. Read-only: nothing is posted, scheduled or stored. To publish a suggestion, call `add_a_comment_to_a_social_selling_post` with the same `postId` or `publishingPostId`, the suggestion’s `identityId`, and its `commentText` as `text`. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 10 requests per minute requestBody: content: application/json: schema: type: object properties: postId: type: integer exclusiveMinimum: 0 description: >- Tracked post id (`id` in the Social Selling posts list). Its text in Enginy is the post to comment on. example: 812 publishingPostId: type: integer exclusiveMinimum: 0 description: >- Publishing post id (`publishingPostId` of a tracked post, or a post scheduled or published from Enginy). Its text is the post to comment on. postContent: type: string minLength: 1 maxLength: 10000 description: >- The post text itself, for a post that is not in Enginy (or has no text there). identityIds: type: array items: type: integer exclusiveMinimum: 0 minItems: 1 maxItems: 20 description: >- Identities that may write a suggestion (at most one suggestion each). Every id must be an identity of this workspace the caller may use. Omit to let the AI pick the most relevant identities the caller may use, never the post’s own author. example: - 12 - 34 tone: type: string enum: - SUPPORTIVE - FUNNY default: SUPPORTIVE description: >- `SUPPORTIVE` (congratulate, agree, add a short insight) or `FUNNY` (good-natured joke). length: type: string enum: - ULTRA_SHORT - SHORT default: SHORT description: '`ULTRA_SHORT` (2–6 words) or `SHORT` (1–2 sentences).' useEmojis: type: boolean default: false description: Add 1–3 emojis per comment. Off by default. count: type: integer minimum: 1 maximum: 6 default: 3 description: >- How many suggestions to write; fewer come back when fewer identities are available. responses: '200': description: Comment suggestions, one per identity content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: suggestions: type: array items: type: object properties: identityId: type: number description: The identity that would post this comment. identityName: type: - string - 'null' commentText: type: string description: The suggested comment, ready to post as is. required: - identityId - identityName - commentText required: - suggestions required: - status - message - data '400': description: >- Not exactly one post source, an invalid option, a post with no text in Enginy (pass `postContent` instead), or no identity available to comment '403': description: >- Social Selling is not enabled for this workspace. Ask your workspace admin to enable the feature. '404': description: >- The post, or one of `identityIds`, is not in this workspace or is outside the caller’s identity scope '503': description: >- The AI generation failed or took longer than 60 seconds; retry the request security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.