> ## 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 sync status

> How fresh each identity’s Social Selling data is: the daily sync cadence and next run, and per identity its status (READY, QUEUED, SYNCING, SYNCED, FAILED, NEEDS_ATTENTION, PAUSED), the issue that needs attention, the last attempt and last success, and whether it can be synced now. Use it to know how old posts, metrics and comments are before reading them. 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/sync-status
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/sync-status:
    get:
      tags:
        - Social Selling
      summary: Get Social Selling sync status
      description: >-
        How fresh each identity’s Social Selling data is: the daily sync cadence
        and next run, and per identity its status (READY, QUEUED, SYNCING,
        SYNCED, FAILED, NEEDS_ATTENTION, PAUSED), the issue that needs
        attention, the last attempt and last success, and whether it can be
        synced now. Use it to know how old posts, metrics and comments are
        before reading them. Read-only.

            > **Required scope:** `SOCIAL_SELLING_READ`
            >
            > **Rate limit:** 100 requests per minute
      responses:
        '200':
          description: Sync status
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      cadence:
                        type: string
                        enum:
                          - DAILY
                      nextRunAt:
                        type: string
                      identities:
                        type: array
                        items:
                          type: object
                          properties:
                            identityId:
                              type: number
                            label:
                              type: string
                            avatarUrl:
                              type:
                                - string
                                - 'null'
                            status:
                              type: string
                              enum:
                                - READY
                                - QUEUED
                                - SYNCING
                                - SYNCED
                                - FAILED
                                - NEEDS_ATTENTION
                                - PAUSED
                            issue:
                              type:
                                - string
                                - 'null'
                              enum:
                                - LINKEDIN_NOT_CONNECTED
                                - CREDENTIALS_EXPIRED
                                - MISSING_SESSION
                                - IDENTITY_LOCKED
                                - RATE_LIMITED
                                - SYNC_FAILED
                                - SYNC_TIMED_OUT
                                - null
                            lastAttemptAt:
                              type:
                                - string
                                - 'null'
                            lastSuccessfulAt:
                              type:
                                - string
                                - 'null'
                            nextScheduledAt:
                              type:
                                - string
                                - 'null'
                            availableAt:
                              type:
                                - string
                                - 'null'
                            canSyncNow:
                              type: boolean
                            analyticsAccess:
                              type: string
                              enum:
                                - UNKNOWN
                                - AVAILABLE
                                - UNAVAILABLE
                            analyticsDataThrough:
                              type:
                                - string
                                - 'null'
                            missedSyncDays:
                              type: number
                          required:
                            - identityId
                            - label
                            - avatarUrl
                            - status
                            - issue
                            - lastAttemptAt
                            - lastSuccessfulAt
                            - nextScheduledAt
                            - availableAt
                            - canSyncNow
                            - analyticsAccess
                            - analyticsDataThrough
                            - missedSyncDays
                    required:
                      - cadence
                      - nextRunAt
                      - identities
                required:
                  - status
                  - message
                  - data
        '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.