Skip to content

Commit 7aaabea

Browse files
committed
docs(content): document publish playback-ready constraints
1 parent 8b8a9fe commit 7aaabea

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

docs/contracts/rest-api-v1.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,8 +85,11 @@ This document defines the MVP API contract groups, standards, and core request/r
8585
- Mutable fields (MVP): `title`, `description`, `visibility`
8686

8787
### `POST /v1/content/{content_id}/publish`
88-
- Idempotent publish request
89-
- Enforces moderation/policy preconditions
88+
- Publishes content from `DRAFT` to `PUBLISHED`
89+
- Request fields (MVP): `userId`
90+
- Requires `playbackReady=true`
91+
- Returns `409 CONTENT_NOT_READY` when playback is not ready
92+
- Returns `409 CONTENT_STATE_INVALID` when state is not `DRAFT`
9093

9194
### `GET /v1/content/{content_id}/playback`
9295
- Returns signed manifest URL and available renditions

0 commit comments

Comments
 (0)