> ## 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. # List Social Selling drafts > Lists the workspace’s drafts (newest change first) for the identities the caller may use, filterable by identity, status, series, pillar and source post. Archived drafts are hidden unless asked for. 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/drafts 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/drafts: get: tags: - Social Selling summary: List Social Selling drafts description: >- Lists the workspace’s drafts (newest change first) for the identities the caller may use, filterable by identity, status, series, pillar and source post. Archived drafts are hidden unless asked for. 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 required: false name: identityIds in: query - schema: type: - array - 'null' items: type: string enum: - DRAFT - SCHEDULED - PUBLISHED - FAILED - CANCELLED - ARCHIVED minItems: 1 description: 'Comma-separated statuses. Default: every status but ARCHIVED.' required: false description: 'Comma-separated statuses. Default: every status but ARCHIVED.' name: statuses in: query - schema: type: string minLength: 1 maxLength: 200 required: false name: series in: query - schema: type: string minLength: 1 maxLength: 200 required: false name: pillar in: query - schema: type: integer exclusiveMinimum: 0 description: Only drafts reusing this tracked post. required: false description: Only drafts reusing this tracked post. name: sourcePostId in: query - schema: type: integer minimum: 1 default: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 50 default: 20 required: false name: pageSize in: query responses: '200': description: Paginated drafts content: application/json: schema: type: object properties: data: type: array items: type: object properties: draftId: type: number version: type: number description: >- Bumped by every edit. Pass it to schedule (approval) and update. status: type: string enum: - DRAFT - SCHEDULED - PUBLISHED - FAILED - CANCELLED - ARCHIVED identity: type: object properties: id: type: number name: type: - string - 'null' required: - id - name title: type: - string - 'null' text: type: string mentions: type: array items: type: object properties: start: type: integer minimum: 0 description: >- Offset in Unicode code points (an emoji counts as one). length: type: integer minimum: 1 kind: type: string enum: - PROFILE - COMPANY urn: type: string minLength: 1 description: >- `urn:li:fsd_profile:` for a person, `urn:li:fsd_company:` for a company page. example: urn:li:fsd_company:98422414 label: type: string minLength: 1 description: Exactly the mentioned slice of `text`. required: - start - length - kind - urn - label description: >- A mention: the slice `text[start, start+length)` links to `urn`. attachments: type: array items: type: object properties: assetId: type: string position: type: number description: 0-based order in the post (or draft). origin: type: string enum: - POST - REPOSTED_POST - UPLOAD type: type: string enum: - IMAGE - VIDEO - DOCUMENT - ARTICLE - POLL - CELEBRATION - REFERENCE mimeType: type: - string - 'null' width: type: - number - 'null' height: type: - number - 'null' sizeBytes: type: - number - 'null' durationMs: type: - number - 'null' pageCount: type: - number - 'null' title: type: - string - 'null' description: type: - string - 'null' altText: type: - string - 'null' altTextSource: type: - string - 'null' enum: - AUTHOR - UPLOADER - null description: >- Who wrote `altText`. Alt text is never generated by Enginy. linkUrl: type: - string - 'null' description: The link of an article or reference card. pollOptions: type: - array - 'null' items: type: string transcript: type: object properties: status: type: string enum: - NOT_COLLECTED required: - status description: >- Video captions and transcripts are not collected from LinkedIn. access: type: object properties: status: type: string enum: - AVAILABLE - EXPIRING - EXPIRED - UNAVAILABLE - PENDING_UPLOAD - NOT_DOWNLOADABLE description: >- AVAILABLE: `downloadUrl` serves the file. EXPIRING: served by LinkedIn until `expiresAt` (refresh for a durable copy). EXPIRED / UNAVAILABLE: no working URL (`reason` says why; refresh). PENDING_UPLOAD: upload not completed. NOT_DOWNLOADABLE: no file (poll, link card). downloadUrl: type: - string - 'null' description: >- HTTPS URL of the original file. Any HTTP client can GET it without a login, cookies or headers. Null unless AVAILABLE or EXPIRING. previewUrl: type: - string - 'null' description: >- A smaller rendition to look at (the image itself; video/document thumbnail). expiresAt: type: - string - 'null' description: >- When `downloadUrl` stops working (null = durable). durable: type: boolean description: >- True when `downloadUrl` is Enginy’s durable copy. refreshable: type: boolean description: >- True when `refresh_social_selling_media_access` can improve it. verifiedAt: type: - string - 'null' description: >- When Enginy confirmed the URL serves the file (null = not probed). reason: type: - string - 'null' required: - status - downloadUrl - previewUrl - expiresAt - durable - refreshable - verifiedAt - reason source: type: - object - 'null' properties: trackedPostId: type: number position: type: number credit: type: - string - 'null' required: - trackedPostId - position - credit description: >- For a copy of a post’s media: where it came from and its credit. required: - assetId - position - origin - type - mimeType - width - height - sizeBytes - durationMs - pageCount - title - description - altText - altTextSource - linkUrl - pollOptions - transcript - access - source firstComment: type: - string - 'null' visibility: type: string enum: - ANYONE - CONNECTIONS postAsCompany: type: boolean companyUrn: type: - string - 'null' lineage: type: object properties: sourcePostId: type: - number - 'null' description: Tracked post it was adapted from. sourceDraftId: type: - number - 'null' sourceAttribution: type: - string - 'null' required: - sourcePostId - sourceDraftId - sourceAttribution planning: type: object properties: series: type: - string - 'null' pillar: type: - string - 'null' objective: type: - string - 'null' audience: type: - string - 'null' factualSources: type: array items: type: string notes: type: - string - 'null' required: - series - pillar - objective - audience - factualSources - notes schedule: type: - object - 'null' properties: publishingPostId: type: number scheduledVersion: type: number scheduledAt: type: string timezone: type: - string - 'null' required: - publishingPostId - scheduledVersion - scheduledAt - timezone createdById: type: - number - 'null' updatedById: type: - number - 'null' createdAt: type: string updatedAt: type: string required: - draftId - version - status - identity - title - text - mentions - attachments - firstComment - visibility - postAsCompany - companyUrn - lineage - planning - schedule - createdById - updatedById - createdAt - updatedAt meta: type: object properties: page: type: number pageSize: type: number total: type: number required: - page - pageSize - total required: - data - meta '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.