update_post_group

posts:write

Edit a post group's shared details: title, topic, objective, timezone or tags (tagIds). The per-platform copy lives on its posts; edit that with update_post. Call it when the user asks to retitle or re-aim a draft; get groupId from list_posts or create_draft_post.

It cannot change status or timing. Changing the title, topic or objective of an approved or scheduled group sends it back to Review as pending approval. Confirm the copy with the user before calling approve_post_group; to discard a draft, use reject_post_group.

Input

• groupIdstring (uuid)required
• titlestring

  min length 1 · max length 140

• topicstring

  max length 500

• objectivestring

  max length 500

• timezonestring

  min length 1

• tagIdsarray<string (uuid)>

Permission

Needs the posts:write scope: create drafts. It changes your workspace, so clients may ask you to confirm each call.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_post_group",
    "arguments": {
      "groupId": "3f8e2c1a-0000-4000-8000-000000000000"
    }
  }
}

Same action over the REST API

The tool runs PATCH /v1/orgs/{orgId}/marketing/post-groups/{groupId} as the signed-in user, with the same validation, approval rules and limits. See it in the Post groups API reference.