Skip to content

Commit c36716f

Browse files
committed
docs(policy): document policy evaluation API
1 parent 46908c7 commit c36716f

2 files changed

Lines changed: 8 additions & 4 deletions

File tree

docs/contracts/rest-api-v1.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,10 @@ This document defines the MVP API contract groups, standards, and core request/r
163163
- Request supports `moderationState` with values `VISIBLE`, `HIDDEN`, or `REMOVED`
164164
- Reuses the content policy record and preserves existing age/geo fields
165165

166+
### `POST /v1/policy/content/{content_id}/evaluate`
167+
- Evaluates whether content is allowed for viewing/playback in a given request context
168+
- Request supports optional `countryCode` and optional `ageVerified`
169+
166170
### `GET /v1/moderation/comments/reports`
167171
- Lists reported comments for moderator queue
168172

docs/mvp-backend-implementation-plan.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -494,7 +494,7 @@ Current completed slices:
494494

495495
Next active slice:
496496

497-
- Policy-service moderation API:
498-
- add `PATCH /v1/moderation/content/{content_id}` for moderation state updates
499-
- preserve existing age/geo policy fields when moderation changes
500-
- keep policy evaluation and downstream enforcement for a follow-up PR
497+
- Policy-service evaluation API:
498+
- add `POST /v1/policy/content/{content_id}/evaluate` for reusable policy decisions
499+
- evaluate moderation, age restriction, and geo policy in one decision flow
500+
- keep downstream enforcement wiring for playback and discovery follow-up PRs

0 commit comments

Comments
 (0)