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

**x-api-key** `string` *required*

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

**projectId** `string` *required*

Text value.

Minimum length: 1. Maximum length: 200. Pattern: `^[^/\\]+$`.

**workId** `string` *required*

Text value.

Minimum length: 1. Maximum length: 200. Pattern: `^[^/\\]+$`.

**title** `string` *required*

Text value.

Minimum length: 1. Maximum length: 100.

**description** `string`

Text value.

Maximum length: 5000.

**youtubeChannelIds** `array`

List of values. See the complete input schema for its item structure.

Maximum items: 20.

**tiktokChannelIds** `array`

List of values. See the complete input schema for its item structure.

Maximum items: 20.

**youtubePrivacyStatus** `string`

Text value.

Allowed values: "public", "unlisted", "private". Default: "private".

**tiktokPrivacyLevel** `string`

Text value.

Allowed values: "PUBLIC\_TO\_EVERYONE", "MUTUAL\_FOLLOW\_FRIENDS", "FOLLOWER\_OF\_CREATOR", "SELF\_ONLY". Default: "SELF\_ONLY".

**includeDynamicSubtitles** `boolean`

Boolean value.

Default: false.

**scheduledAt** `string`

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)))$`.

**requestId** `string`

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}$`.

> [accordion] Complete input schema
>
> 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.