---
title: "List social publications"
method: GET
path: "/v1/videos/{id}/publish"
tags: ["Videos"]
---

# List social publications

`GET /v1/videos/{id}/publish`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/videos/{id}/publish`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/publish/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the latest publish of the video to each social destination and account, including publishes made in the Tella app. Poll this after POST /v1/videos/{id}/publish until the publication's status is `completed` (with the post `url`) or `failed` (with `error`). Requires edit access to the video.

## Path parameters

- `id` string, required: Unique video identifier

## Response `200`

OK

- ListPublicationsResponse
  - `publications` Publication[], required: The latest publish to each destination and account
    - `accountId` string, nullable, required: The connected account it was published with; null for publishes made before Tella supported several accounts
    - `accountName` string, nullable, required: That account's name in Tella
    - `captionsError` string, nullable, required: Set on a completed YouTube publish whose caption track was refused
    - `createdAt` string, required
    - `destination` string, required: One of the request destinations, or tiktok
    - `error` string, nullable, required: Why a failed publish failed and what to do next, as a sentence for people. Never the destination's raw response
    - `privacy` 'public' | 'unlisted' | 'private' | 'followers' | 'friends', required
    - `providerVideoId` string, nullable, required
    - `scheduledAt` string, nullable, required: When a scheduled publish goes out; null when it wasn't scheduled
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled', required: A scheduled publish stays `queued` until its time, and is `cancelled` if taken back before then
    - `title` string, required
    - `updatedAt` string, required
    - `url` string, nullable, required: The post on the destination, once completed

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 67 revisions in range; 1 not diffed.

- **2026-10-15** `12b6eccbb321`: 1 warning, 1 info
  - added the new `cancelled` enum value to the `publications/items/status` response property for the response status `200`
  - added the required property `publications/items/scheduledAt` to the response with the `200` status
- **2026-10-09** `9773130bbc2b`: 2 info
  - added the required property `publications/items/accountId` to the response with the `200` status
  - added the required property `publications/items/accountName` to the response with the `200` status
- **2026-09-30** `d3eafbc27bf9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/publish/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/668da8c6d5f6?raw)