> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumisreach.com/llms.txt > Use this file to discover all available pages before exploring further. # Post a video > Post a `ready` video to connected social accounts (`GET /v1/social-connections`) now, or at `scheduled_for`. One post per account, so a failure on one network leaves the others alone. `caption` defaults to the video's caption and hashtags; `captions` overrides it per platform. A slideshow can go out as its slides with `media_type: carousel` (TikTok and Instagram). Cancel a scheduled post with `DELETE /v1/posts/{id}`. Free. ## OpenAPI ````yaml /openapi.json post /v1/videos/{id}/posts openapi: 3.1.0 info: title: LumisReach v1 API version: 1.0.0 description: >- Programmatic access to the LumisReach voice platform — calls, numbers, caller trust, and brands. contact: name: LumisReach email: founders@lumisreach.com servers: - url: https://api.lumisreach.com/api security: - bearerAuth: [] tags: - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Billing - name: Conversation History - name: Documents - name: Lincoln AI - name: Quick Agent Actions - name: Sub-entities - name: Video schedules - name: Videos paths: /v1/videos/{id}/posts: post: tags: - Videos summary: Post a video description: >- Post a `ready` video to connected social accounts (`GET /v1/social-connections`) now, or at `scheduled_for`. One post per account, so a failure on one network leaves the others alone. `caption` defaults to the video's caption and hashtags; `captions` overrides it per platform. A slideshow can go out as its slides with `media_type: carousel` (TikTok and Instagram). Cancel a scheduled post with `DELETE /v1/posts/{id}`. Free. operationId: v1_videos_id_posts_post parameters: - name: id in: path required: true schema: type: string - name: Idempotency-Key in: header required: false description: >- A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency. schema: type: string requestBody: required: true content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: connection_ids: minItems: 1 type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Accounts to post to, from `GET /v1/social-connections` caption: description: >- The caption for every platform without its own. Omit to use the video's caption and hashtags. type: string maxLength: 4000 captions: description: >- A platform's own caption, checked against that platform's limits type: object propertyNames: type: string enum: - tiktok - instagram - facebook - x - linkedin additionalProperties: type: string maxLength: 4000 media_type: default: video description: >- `carousel` posts a slideshow's slides (TikTok and Instagram only) type: string enum: - video - carousel scheduled_for: description: >- Post at this time (at least a minute ahead, up to a year). Omit to post now. type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ settings: default: {} description: Per-platform options; omitted ones use their defaults type: object properties: tiktok: type: object properties: mode: description: >- `draft` sends it to the TikTok inbox to finish in the app type: string enum: - direct - draft privacy_level: type: string enum: - public_to_everyone - mutual_follow_friends - follower_of_creator - self_only allow_comments: type: boolean allow_duet: type: boolean allow_stitch: type: boolean is_ai_generated: type: boolean promotes_own_business: type: boolean paid_partnership: type: boolean cover_seconds: anyOf: - type: number minimum: 0 maximum: 600 - type: 'null' photo_title: type: string maxLength: 90 auto_add_music: type: boolean photo_cover_index: type: integer minimum: 0 maximum: 34 additionalProperties: false instagram: type: object properties: share_to_feed: type: boolean location_id: description: A Facebook Page id with an address type: - string - 'null' user_tags: maxItems: 20 type: array items: type: string collaborators: maxItems: 3 type: array items: type: string alt_texts: maxItems: 10 type: array items: type: string maxLength: 1000 audio_name: anyOf: - type: string maxLength: 100 - type: 'null' cover_seconds: anyOf: - type: number minimum: 0 maximum: 900 - type: 'null' is_ai_generated: type: boolean additionalProperties: false facebook: type: object properties: published: type: boolean title: anyOf: - type: string maxLength: 255 - type: 'null' additionalProperties: false x: type: object properties: reply_settings: type: string enum: - everyone - following - mentioned_users additionalProperties: false linkedin: type: object properties: visibility: type: string enum: - public - connections additionalProperties: false additionalProperties: false required: - connection_ids - media_type - settings additionalProperties: false responses: '200': description: Success content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: data: type: object properties: scheduled_for: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' posts: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ connection_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ required: - id - connection_id additionalProperties: false required: - scheduled_for - posts additionalProperties: false required: - data additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer ````