> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Publish original video > Publish or schedule original project media to your own connected YouTube/TikTok channels, optionally with dynamic subtitles. This publishes externally; choose privacy explicitly when public access is intended. Publish or schedule original project media to your own connected YouTube/TikTok channels, optionally with dynamic subtitles. This publishes externally; choose privacy explicitly when public access is intended. ```http theme={null} POST https://api.voicecheap.ai/v1/actions/publishing_original_create ``` ## Authentication and permissions Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by MCP, not by this REST endpoint. Required permissions: `publishing:write`, `projects:read`. An active paid subscription is required. Permissions do not change team roles, resource ownership, media credits, or plan limits. ## Parameters Text value. Minimum length: 1. Maximum length: 200. Pattern: `^[^/\\]+$`. Text value. Minimum length: 1. Maximum length: 200. Pattern: `^[^/\\]+$`. Text value. Minimum length: 1. Maximum length: 100. Text value. Maximum length: 5000. List of values. See the complete input schema for its item structure. Maximum items: 20. List of values. See the complete input schema for its item structure. Maximum items: 20. Text value. Allowed values: "public", "unlisted", "private". Default: "private". Text value. Allowed values: "PUBLIC\_TO\_EVERYONE", "MUTUAL\_FOLLOW\_FRIENDS", "FOLLOWER\_OF\_CREATOR", "SELF\_ONLY". Default: "SELF\_ONLY". Boolean value. Default: false. Text value. 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)))$`. Optional at the transport boundary: the server injects an identifier before validation when omitted. Supply your own stable UUID v4 to recover safely from a lost response. Format: "uuid". Pattern: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$`. The JSON Schema below preserves the exact field names, nested types, defaults, bounds, and accepted values exposed by discovery. Additional cross-field rules are listed in the operation notes. ```json theme={null} { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^/\\\\]+$" }, "workId": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^/\\\\]+$" }, "title": { "type": "string", "minLength": 1, "maxLength": 100 }, "description": { "type": "string", "maxLength": 5000 }, "youtubeChannelIds": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^/\\\\]+$" } }, "tiktokChannelIds": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^/\\\\]+$" } }, "youtubePrivacyStatus": { "default": "private", "type": "string", "enum": ["public", "unlisted", "private"] }, "tiktokPrivacyLevel": { "default": "SELF_ONLY", "type": "string", "enum": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY"] }, "includeDynamicSubtitles": { "default": false, "type": "boolean" }, "scheduledAt": { "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)))$" }, "requestId": { "type": "string", "format": "uuid", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "description": "UUID v4 for this action. Reuse the same ID with identical arguments on retries." } }, "required": ["projectId", "workId", "title"], "additionalProperties": false } ``` ## Idempotency Use a UUID v4 in requestId or the Idempotency-Key HTTP header for each mutation. Reuse the same identifier and identical arguments after a network failure. If both are supplied, they must match. Replaying a saved request does not repeat the operation or charge another monthly call. Failed or interrupted requests are not restarted automatically. Every mutation can return HTTP 202 when a retry finds the same request still running, even when its first execution is normally synchronous. If execution completed but resultStored is false, a retry returns HTTP 200 with saved request state instead of the original result. Retrieve the output through its domain history, result, or download action. ## Request examples Replace example resource identifiers and media keys with values returned for your account. Keep the request identifier stable when retrying the same mutation. ```bash cURL theme={null} curl --request POST 'https://api.voicecheap.ai/v1/actions/publishing_original_create' \ --header "x-api-key: $VOICECHEAP_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"projectId":"project_launch_2026","workId":"5f8423d1-e4c0-4f80-9e3f-eed959389e24","title":"Product launch","description":"Meet the new product.","youtubeChannelIds":["UC1234567890abcdefghijkl"],"youtubePrivacyStatus":"private","includeDynamicSubtitles":false,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991"}' ``` ```javascript JavaScript theme={null} const input = { projectId: 'project_launch_2026', workId: '5f8423d1-e4c0-4f80-9e3f-eed959389e24', title: 'Product launch', description: 'Meet the new product.', youtubeChannelIds: ['UC1234567890abcdefghijkl'], youtubePrivacyStatus: 'private', includeDynamicSubtitles: false, requestId: '41321bda-e243-4b6f-96a4-622cd047c991', }; const response = await fetch('https://api.voicecheap.ai/v1/actions/publishing_original_create', { method: 'POST', headers: { 'x-api-key': process.env.VOICECHEAP_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify(input), }); const body = await response.json(); if (!response.ok) throw new Error(body.code + ': ' + body.message); console.log(body); ``` ```python Python theme={null} import os import requests response = requests.post( "https://api.voicecheap.ai/v1/actions/publishing_original_create", headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]}, json={"projectId": "project_launch_2026", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "title": "Product launch", "description": "Meet the new product.", "youtubeChannelIds": ["UC1234567890abcdefghijkl"], "youtubePrivacyStatus": "private", "includeDynamicSubtitles": False, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"}, timeout=120, ) body = response.json() if not response.ok: raise RuntimeError(f"{body.get('code')}: {body.get('message')}") print(body) ``` ## Response This operation returns HTTP 202 while running. Save requestId and poll action\_request\_get with that identifier and the original operation name. Polling states are running, completed, failed, and interrupted. A completed result can point to a separate media job; continue with the operation-specific status or output action. Returns the refreshed public original publication state after requesting publication or scheduling to selected channels. ```json HTTP 202 theme={null} { "data": { "requestId": "41321bda-e243-4b6f-96a4-622cd047c991", "status": "running", "pollAction": "action_request_get", "pollAfterSeconds": 5 }, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991" } ``` ```json HTTP 200 theme={null} { "data": { "projectId": "project_launch_2026", "originalPublish": { "id": "7db6b953-7664-4bc2-811a-6aa7aa29038d", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "title": "Product launch", "description": "Meet the new product.", "status": "completed", "useDynamicSubtitles": false, "createdAt": 1792152000000, "updatedAt": 1792152060000, "channels": [ { "channelId": "UC1234567890abcdefghijkl", "platform": "youtube", "status": "completed", "videoId": "example1234", "videoUrl": "https://www.youtube.com/watch?v=example1234" } ] } }, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991" } ``` ```json HTTP 202 replay_running theme={null} { "data": { "requestId": "41321bda-e243-4b6f-96a4-622cd047c991", "operation": "publishing_original_create", "createdAt": 1792144800000, "updatedAt": 1792144820000, "status": "running", "pollAfterSeconds": 5 }, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991" } ``` ```json HTTP 200 replay_completed_without_result theme={null} { "data": { "requestId": "41321bda-e243-4b6f-96a4-622cd047c991", "operation": "publishing_original_create", "createdAt": 1792144800000, "updatedAt": 1792144820000, "status": "completed", "resultStored": false, "message": "The action completed. Retrieve its output from the corresponding history or resource action." }, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991" } ``` ## Result fields | Field | Description | | - | - | | `data.projectId` | Parent project identifier. | | `data.originalPublish` | Refreshed public original publication state, or null. | | `data.originalPublish.id` | Original publication attempt identifier. | | `data.originalPublish.workId` | Optional language-work identifier used by the original publishing workflow. | | `data.originalPublish.title` | Publication title. | | `data.originalPublish.description` | Optional description. | | `data.originalPublish.status` | idle, scheduled, in-progress, completed, or failed. | | `data.originalPublish.useDynamicSubtitles` | Whether the original publishing workflow requested dynamic subtitles. | | `data.originalPublish.dynamicSubtitlesVideoUrl` | Optional generated subtitle-video URL. | | `data.originalPublish.scheduledAt` | Optional scheduled time in Unix milliseconds. | | `data.originalPublish.createdAt` | Creation time in Unix milliseconds. | | `data.originalPublish.updatedAt` | Latest update time in Unix milliseconds. | | `data.originalPublish.channels` | Per-channel state with channelId, platform, status and optional videoId, videoUrl, scheduledAt. | ## Recover and poll this request Use the same identifier even after a lost connection. If resultStored is false, retrieve the output through the corresponding history, result, or download action. Never start a second generation merely to check progress. ```bash theme={null} curl --request POST 'https://api.voicecheap.ai/v1/actions/action_request_get' \ --header "x-api-key: $VOICECHEAP_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"requestId":"41321bda-e243-4b6f-96a4-622cd047c991","operation":"publishing_original_create"}' ``` ```json HTTP 200 theme={null} { "data": { "requestId": "41321bda-e243-4b6f-96a4-622cd047c991", "operation": "publishing_original_create", "status": "completed", "createdAt": 1792144800000, "updatedAt": 1792144820000, "resultStored": true, "result": { "projectId": "project_launch_2026", "originalPublish": { "id": "7db6b953-7664-4bc2-811a-6aa7aa29038d", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "title": "Product launch", "description": "Meet the new product.", "status": "completed", "useDynamicSubtitles": false, "createdAt": 1792152000000, "updatedAt": 1792152060000, "channels": [ { "channelId": "UC1234567890abcdefghijkl", "platform": "youtube", "status": "completed", "videoId": "example1234", "videoUrl": "https://www.youtube.com/watch?v=example1234" } ] } } } } ``` ## Operation notes * This publishes externally and requires project ownership. At least one youtubeChannelIds or tiktokChannelIds array must contain a channel connected to the authenticated actor; each array allows at most 20 entries. * workId must belong to this project even though the selected media is the original video. * The integration defaults to youtubePrivacyStatus private and tiktokPrivacyLevel SELF\_ONLY. Set the desired privacy explicitly when broader access is intended. * includeDynamicSubtitles defaults to false and requires subtitles:write when enabled. It uses normal subtitle allowances and media credits. * scheduledAt is an optional ISO datetime with an offset. Only a time strictly in the future schedules the original workflow; a valid past timestamp does not schedule it and may publish immediately. * This is a long-running action. Poll action\_request\_get for handler completion, then publishing\_list for resource publication progress or scheduled results. * originalPublish may be null when no state is available, or show in-progress, scheduled, completed or failed state. Individual channel outcomes are in channels, so a returned result does not guarantee successful publication to every channel. ## Usage Each successful invocation consumes one monthly API/MCP call. Media credits and the operation's own generation allowances also apply. ## Errors | HTTP status | Code | Meaning or recovery | | - | - | - | | 400 | `BAD_REQUEST` | Original media is unavailable, another original publication is active, or the publishing input is invalid. | | 400 | `CREDENTIAL_IN_QUERY` | Credentials were supplied in an access\_token or api\_key query parameter. Send credentials in headers. | | 400 | `IDEMPOTENCY_CONFLICT` | The Idempotency-Key header and requestId body field must match. | | 400 | `INVALID_REQUEST_ID` | Supply a UUID v4 requestId or Idempotency-Key. | | 400 | `VALIDATION_ERROR` | Correct the input using the schema. Invalid or inconsistent values are rejected before execution. | | 401 | `API_KEY_EXPIRED` | The API key has expired. | | 401 | `INVALID_API_KEY` | Provide a valid, unexpired API key. | | 401 | `INVALID_CREDENTIAL` | The Authorization header is malformed or conflicts with x-api-key. | | 401 | `MISSING_CREDENTIAL` | No usable header credential was supplied, or it exceeded 4096 characters. | | 401 | `USER_NOT_FOUND` | The credential's account no longer exists. | | 403 | `ACCOUNT_UNAVAILABLE` | The acting or billing account is unavailable or being deleted. | | 403 | `AMBIGUOUS_TEAM_API_KEY` | The credential's user belongs to more than one team, so the billing context is ambiguous. | | 403 | `FORBIDDEN` | The authenticated actor cannot access this project. | | 403 | `INSUFFICIENT_SCOPE` | includeDynamicSubtitles true additionally requires subtitles:write. | | 403 | `INTEGRATION_PLAN_UNSUPPORTED` | The account's integration limits could not be verified. | | 403 | `OWNER_REQUIRED` | Only the project owner can publish original project media. | | 403 | `PUBLISHING_CHANNEL_FORBIDDEN` | Every selected channel must belong to the authenticated actor. | | 403 | `SUBSCRIPTION_REQUIRED` | Use an active paid subscription. | | 403 | `TEAM_OWNER_NOT_FOUND` | The effective team owner account could not be found. | | 404 | `PROJECT_NOT_FOUND` | The project does not exist in the accessible account. | | 404 | `TRANSLATION_NOT_FOUND` | workId does not identify a language work owned by this project. | | 409 | `CONCURRENT_ACTION_LIMIT_REACHED` | This account already has 10 integration actions running. Poll an existing request before starting another. | | 409 | `IDEMPOTENCY_CONFLICT` | Reuse an identifier only with the same operation and arguments. | | 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Wait for the monthly reset or change plan. | | 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Wait for Retry-After when present and use backoff. | | 500 | `INTERNAL_ERROR` | Check saved request state and resource history before deciding to retry a mutation. | | 503 | `ACTION_RESULT_UNAVAILABLE` | The action ran but its result could not be saved. Inspect saved request state and resource history before starting a new generation. | | 503 | `SERVER_RESTARTING` | The server is restarting. Retry shortly and keep the same request identifier for a mutation. | ```json theme={null} { "code": "INSUFFICIENT_SCOPE", "message": "This credential does not permit the requested action.", "status": 403, "details": { "requiredScopes": ["publishing:write", "projects:read"] } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.