Change a member's role or brand list

Owner or admin; never the owner (ownership moves with POST /api/team/transfer). Only a person signed in to the dashboard (its session key plus X-PostWire-Source: dashboard): an API key or an AI connector gets 403 team_requires_human, even an admin's. brand_ids applies to editor, contributor, approver and viewer; [] = every brand.

patch/api/team/members/{id}

Request

  • Base URL: https://postwire.io
  • URL: https://postwire.io/api/team/members/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The member's account_id

Request body

role'admin' | 'editor' | 'contributor' | 'approver' | 'viewer'

admin: everything except billing and ownership. editor: write, schedule, publish within approval rules. contributor: drafts and schedules, every post waits for approval. approver: only the approvals inbox. viewer: read-only.

brand_idsstring[]

Only these brands of the workspace (editor, contributor, approver, viewer). Empty or omitted = every brand.

Response

{ ok, member: { account_id, role, brand_ids } }

Changes

No recorded changes to this operation across all 1 revision of this API.