For approval
Overview
Content → For approval shows all posts someone submitted for approval in the studio or in the editor — whoever has waited longest comes first. For each post you see the preview as on the network; with several networks, switch via the bar above it.
One click approves and schedules: the post goes to all selected networks at the suggested time. A second click returns it with a note: the author receives a notification and sees the note on the post.
The page is built for phones: one column, large buttons, networks to swipe.
Core tasks
1. Approve & schedule
Look through the preview per network, then Approve & schedule. The post is scheduled at the suggested time (shown below the title) and leaves the list. To set a different time, use Open in the studio.
2. Return with a note
Return, then write what should change — “Please without the price”, “avoid images with faces”. The note is required. The post becomes a draft again; the author receives a notification with the note and a link to the studio, where the note shows at the top. Once they submit the post again, the note is done.
3. Viewing without the approval right
Without the approval right you see the list and the preview, but no buttons — approval stays with those who may publish.
Fields in detail
The list comes from GET /v1/content/approvals (per post the same view as the studio, with canPublish); optionally limited to one brand (brandId). Approve & schedule sends the suggested time to POST /v1/content/items/{ulid}/schedule — the post’s fields are explained under Items. The only input on this page is the note when returning (POST /v1/content/items/{ulid}/return):
| Field | Required | Values / format | Effect |
|---|---|---|---|
What should change? note | yes | text, at most 1000 characters | Then stays on the post as reviewFeedback (note, time, who) and in the notification to the author. |
Only posts waiting for approval can be returned; otherwise the API answers with 422.
Settings & permissions
- Viewing the list requires seeing items in the brand (
content.item.view). - Approving and returning requires “Publish and withdraw items” (
content.item.publish) **in the
post’s brand**.
- The notification “Post returned from approval” can be switched off in your own notification
settings.
FAQ & troubleshooting
A submitted post is missing. It belongs to a brand in which you cannot see items — or it has already been scheduled.
The suggested time does not fit. Open, change the time in the studio and use Approve & schedule there.