> ## 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. # Get Social Selling capabilities > What you can do in Social Selling and why not when you cannot. Per identity you may see: LinkedIn connection health (expired session, LinkedIn restriction, sync state, creator analytics), the owner’s consent to colleagues commenting, reposting, saving or reacting, and each action’s status — AVAILABLE, REQUIRES_OWNER_APPROVAL (the owner approves before it runs), DENIED_PERMISSION (your credential’s scopes or the owner’s consent), UNHEALTHY_CONNECTION (fix the LinkedIn connection first) or UNAVAILABLE_PROVIDER (not supported at all). Also the supported media formats and limits, post visibility, company-page posting and which analytics exist (daily cadence, no hourly data, no clicks or saves). Call it before publishing or engaging from an identity. Read-only. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/capabilities 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/capabilities: get: tags: - Social Selling summary: Get Social Selling capabilities description: >- What you can do in Social Selling and why not when you cannot. Per identity you may see: LinkedIn connection health (expired session, LinkedIn restriction, sync state, creator analytics), the owner’s consent to colleagues commenting, reposting, saving or reacting, and each action’s status — AVAILABLE, REQUIRES_OWNER_APPROVAL (the owner approves before it runs), DENIED_PERMISSION (your credential’s scopes or the owner’s consent), UNHEALTHY_CONNECTION (fix the LinkedIn connection first) or UNAVAILABLE_PROVIDER (not supported at all). Also the supported media formats and limits, post visibility, company-page posting and which analytics exist (daily cadence, no hourly data, no clicks or saves). Call it before publishing or engaging from an identity. Read-only. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 minItems: 1 description: >- Only these identities (comma-separated). Defaults to every identity the caller may see. example: 228,323 required: false description: >- Only these identities (comma-separated). Defaults to every identity the caller may see. name: identityIds in: query responses: '200': description: >- Caller scopes, formats, analytics, unsupported capabilities and per-identity actions content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: caller: type: object properties: read: type: boolean description: The credential has SOCIAL_SELLING_READ. write: type: boolean description: The credential has SOCIAL_SELLING_WRITE. restrictedToIdentities: type: boolean description: The caller only sees some identities. required: - read - write - restrictedToIdentities formats: type: object properties: image: type: object properties: mimeTypes: type: array items: type: string maxBytes: type: number maxCount: type: number altTextMaxLength: type: number required: - mimeTypes - maxBytes - maxCount - altTextMaxLength video: type: object properties: mimeTypes: type: array items: type: string minBytes: type: number maxBytes: type: number maxCount: type: number minDurationSeconds: type: number maxDurationSeconds: type: number required: - mimeTypes - minBytes - maxBytes - maxCount - minDurationSeconds - maxDurationSeconds document: type: object properties: mimeTypes: type: array items: type: string maxBytes: type: number maxCount: type: number titleMaxLength: type: number required: - mimeTypes - maxBytes - maxCount - titleMaxLength mixedMediaTypes: type: boolean enum: - false required: - image - video - document - mixedMediaTypes visibility: type: array items: type: string enum: - ANYONE - CONNECTIONS companyPages: type: object properties: supported: type: boolean enum: - true note: type: string required: - supported - note analytics: type: object properties: cadence: type: string enum: - DAILY hourly: type: boolean enum: - false publicationWindows: type: array items: type: string enum: - firstDay - firstWeek impressions: type: string breakdowns: type: array items: type: string notMeasured: type: array items: type: string required: - cadence - hourly - publicationWindows - impressions - breakdowns - notMeasured unsupported: type: array items: type: object properties: capability: type: string status: type: string enum: - UNAVAILABLE_PROVIDER reason: type: string required: - capability - status - reason identities: type: array items: type: object properties: id: type: number name: type: - string - 'null' linkedInUrl: type: - string - 'null' connection: type: object properties: status: type: string enum: - HEALTHY - UNHEALTHY issues: type: array items: type: string linkedinCredentialsExpired: type: boolean restrictedUntil: type: - string - 'null' sync: type: object properties: status: type: - string - 'null' lastSucceededAt: type: - string - 'null' failureMessage: type: - string - 'null' required: - status - lastSucceededAt - failureMessage creatorAnalytics: type: string enum: - AVAILABLE - UNAVAILABLE - UNKNOWN required: - status - issues - linkedinCredentialsExpired - restrictedUntil - sync - creatorAnalytics consent: type: object properties: callerIsOwner: type: boolean comment: type: string enum: - ALLOWED - MANUAL_REVIEW - DENIED repost: type: string enum: - ALLOWED - MANUAL_REVIEW - DENIED save: type: string enum: - ALLOWED - MANUAL_REVIEW - DENIED react: type: string enum: - ALLOWED - DENIED required: - callerIsOwner - comment - repost - save - react actions: type: array items: type: object properties: action: type: string enum: - READ_POSTS - READ_ANALYTICS - READ_COMMENTS - PUBLISH_POST - SCHEDULE_POST - POST_AS_COMPANY_PAGE - COMMENT - REPLY_TO_COMMENT - DELETE_OWN_COMMENT - EDIT_POSTED_COMMENT - REACT - REPOST - SAVE status: type: string enum: - AVAILABLE - REQUIRES_OWNER_APPROVAL - DENIED_PERMISSION - UNHEALTHY_CONNECTION - UNAVAILABLE_PROVIDER reason: type: - string - 'null' required: - action - status - reason required: - id - name - linkedInUrl - connection - consent - actions required: - caller - formats - visibility - companyPages - analytics - unsupported - identities required: - status - message - data '400': description: Invalid identity ids or more than 200 of them '403': description: >- Social Selling is not enabled for this workspace. Ask your workspace admin to enable the feature. 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.