---
title: "Publish a rendered video to a connected social account (video -> post)."
method: POST
path: "/api/v1/posts/publish-video"
tags: ["Posts"]
---

# Publish a rendered video to a connected social account (video -> post).

`POST /api/v1/posts/publish-video`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/posts/publish-video`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Ownership-scoped to the caller. Generates a caption when none is supplied<br/>and returns it. A missing/unrendered video 404s; a missing social account<br/>comes back as a 200 with success=False and a connect instruction.

## Request body

- PublishVideoRequest
  - `caption` string, nullable
  - `platform` string, required
  - `video_id` integer, required

## Response `200`

OK

- PublishVideoResponse
  - `caption` string
  - `message` string
  - `platform` string, required
  - `success` boolean, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)