> ## 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. # Preview a Social Selling draft > Exactly what would be published for the draft’s current `version`: who it posts as (person or page), the text as readers see it (mentions as @Label, links, the "see more" fold), each media file with a probed download URL, the first comment and whether the identity’s owner must approve it, visibility — and `checks` (ERROR blocks scheduling: disconnected identity, unreachable media; WARNING/INFO explain the rest). `ready` = no ERROR. 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/{draftId}/preview 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/{draftId}/preview: get: tags: - Social Selling summary: Preview a Social Selling draft description: >- Exactly what would be published for the draft’s current `version`: who it posts as (person or page), the text as readers see it (mentions as @Label, links, the "see more" fold), each media file with a probed download URL, the first comment and whether the identity’s owner must approve it, visibility — and `checks` (ERROR blocks scheduling: disconnected identity, unreachable media; WARNING/INFO explain the rest). `ready` = no ERROR. Read-only. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: integer exclusiveMinimum: 0 description: Draft id (`draftId`). required: true description: Draft id (`draftId`). name: draftId in: path responses: '200': description: The preview of the current version content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: draftId: type: number version: type: number status: type: string enum: - DRAFT - SCHEDULED - PUBLISHED - FAILED - CANCELLED - ARCHIVED publishAs: type: object properties: kind: type: string enum: - PERSON - COMPANY identityId: type: number identityName: type: - string - 'null' linkedInUrl: type: - string - 'null' imageUrl: type: - string - 'null' companyUrn: type: - string - 'null' required: - kind - identityId - identityName - linkedInUrl - imageUrl - companyUrn text: type: string renderedText: type: string description: The text as readers see it (`@Label` for mentions). characterCount: type: number foldPreview: type: string description: What shows before "…see more". 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`. links: type: array items: type: string media: 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: - object - 'null' properties: text: type: string links: type: array items: type: string requiresOwnerApproval: type: boolean required: - text - links - requiresOwnerApproval visibility: type: string enum: - ANYONE - CONNECTIONS ready: type: boolean description: >- No ERROR check stands in the way of scheduling this version. checks: type: array items: type: object properties: code: type: string level: type: string enum: - ERROR - WARNING - INFO message: type: string required: - code - level - message required: - draftId - version - status - publishAs - text - renderedText - characterCount - foldPreview - mentions - links - media - firstComment - visibility - ready - checks required: - status - message - data '403': description: >- Social Selling is not enabled for this workspace. Ask your workspace admin to enable the feature. '404': description: >- Draft not found in this workspace or outside the caller’s identity scope 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.