social:approve
social family
A person approves, edits-then-approves, or rejects one queued social post. The only door that stamps a post publishable: the stamp covers these exact words and media, so an edit after approval voids it. Needs the workspace's owner/admin seat (or the agency above) and a person — a bare API key or an agent is refused. Instagram without an image or video is refused (instagram_media_required). Reject marks a variant skipped (a master post goes back to draft) with the reason.
- Effect
- ask
- Awaits an outcome — the call returns the response below.
- Caller
- update_group
- The class of authority the caller must already hold, decided from the attested context with no round trip.
- Cost
- free
- What one call costs, so you can budget before acting.
- Reversible
- yes
- The effect can be undone by a later call.
- Idempotent
- yes
- Safe to retry as-is.