buffer__list_organizations | Read | The Buffer organizations the connected key reaches (id, name, channel count, plan limits: channels, ideas, scheduled posts, tags) and the key's rate-limit windows left (15 min / 24 h / 30 days, shared by every key and… |
buffer__list_channels | Read | The channels of a Buffer organization (connected social profiles): id, service (twitter, linkedin, bluesky, instagram, facebook, threads, mastodon, tiktok, youtube, pinterest, googlebusiness, substack), type (profile … |
buffer__get_channel | Read | ONE channel (the selected one, or channelId): the fields list_channels returns plus Mastodon's server limit. |
buffer__list_posts | Read | Posts of the selected channel(s), newest first (cursor-paged; truncated + nextCursor when more exist): id, status (draft | needs_approval | scheduled | sending | sent | error), dueAt / sentAt, text, share mode, exte… |
buffer__get_post | Read | ONE post by id (status, text, times, media, tags, error, the actions this key may take on it). |
buffer__post_metrics | Read | Performance of ONE sent post as Buffer normalizes it (reactions, comments, reposts, shares, impressions, reach, views, clicks, engagementRate % …) with metricsUpdatedAt — refreshed once a day, so up to ~24 h behind; a… |
buffer__aggregate_metrics | Read | Post metrics summed over a window (postCount, reactions, comments always; richer metrics only when EVERY channel in the filter reports them). |
buffer__list_ideas | Read | The organization's ideas (content backlog not tied to a channel): id, title, text, target date, services, created / updated. |
buffer__list_tags | Read | The organization's tags (id, name, color, locked — a locked tag cannot be renamed). |
buffer__list_content_drafts | Read | The organization's content items (channel-less drafts and multi-channel items): id, title, target date (a planning aid, never a schedule), the draft text while it is a draft. |
buffer__list_notes | Read | The team notes on a post or a channel-less draft, newest first. |
buffer__get_limits | Read | What may still be posted: each channel's daily posting limit at a time (X: the busiest rolling 24 h; others: the channel's local day) with scheduled / sent counts, the organization's plan limits (scheduled posts, idea… |
buffer__character_limits | Read | The text limit of a channel's network and how Buffer counts it (UTF-16; X weighted with URLs 23; LinkedIn URLs 24; Instagram line breaks 2; Bluesky graphemes; Mastodon the server's limit), first-comment and title limi… |
buffer__get | Read | ANY Buffer GraphQL READ in Buffer's own format: { query (a query document — account, channels, channel, posts, post, ideas, tagsV2, tag, contentItems, contentItem, collaborationNotes, dailyPostingLimits, aggregatedPos… |
buffer__create_draft | Write | A DRAFT post on the selected channel (createPost saveToDraft:true — status draft, never published until someone schedules it): { accountId? (a connected Buffer channel; optional when the workspace has one), text, medi… |
buffer__update_draft | Write | Change a DRAFT post (read first — anything that is not a draft is refused here: update_post): { postId, text?, media? (replaces), metadata?, tagIds? }. |
buffer__delete_draft | Write | Delete a DRAFT post (read first; a scheduled or sent post is delete_post and waits for a person): { postId }. |
buffer__create_idea | Write | Save an idea in the organization's backlog (no channel, never published): { organizationId?, title?, text, services? (["twitter", "linkedin" …] — a label only), date? (a planning date) }. |
buffer__create_content_draft | Write | A channel-less draft (a content item) in the organization — no channel, no network rules, never published until promoted in Buffer: { organizationId?, text, title?, targetDate? (a planning aid only), media?, tagIds? }. |
buffer__update_content_draft | Write | Replace a channel-less draft's content in full (only while it is still a draft): { contentItemId, text, media?, title?, targetDate? }. |
buffer__delete_content_draft | Write | Delete a channel-less draft (read first — an item that already holds channel posts is refused here; it is delete_post per post). { contentItemId }. |
buffer__set_post_tags | Write | Add / remove tags on a post (read first; nothing else about the post changes): { postId, add? [tagId], remove? [tagId] }. |
buffer__create_tag | Write | A tag in the organization: { organizationId?, name (1–100, unique, case-sensitive), color (#RRGGBB) }. |
buffer__update_tag | Write | Rename / recolor a tag (read first; Buffer replaces BOTH, so the one not named keeps its value; a locked tag cannot be edited): { tagId, name?, color? }. |
buffer__create_note | Write | A team note on a post or channel-less draft (never published): { postId | contentItemId, text }. |
buffer__update_note | Write | Replace a note's text: { noteId, text }. |
buffer__delete_note | Write | Delete a note (permanent): { noteId }. |
buffer__schedule_post | Write — always a person | Schedule a post on the selected channel — a new one { accountId? (a connected Buffer channel; optional when the workspace has one), text, media? ([{ url, type?: image | video | document, title?, thumbnailUrl? (documen… |
buffer__share_now | Write — always a person | Publish NOW on the selected channel — a new post { accountId? (a connected Buffer channel; optional when the workspace has one), text, media?, metadata? } or an existing draft / queued post { postId }; projectId?, pro… |
buffer__update_post | Write — always a person | Change a scheduled / queued post (what will go out, or when): { postId, text?, media?, metadata?, dueAt?, tagIds? }. |
buffer__move_in_queue | Write — always a person | Move a queued post to the top (next slot) or bottom of its channel's queue: { postId, position: top | bottom }. |
buffer__delete_post | Write — always a person | Delete a scheduled or sent post from Buffer: { postId }. |
buffer__delete_tag | Write — always a person | Delete a tag — it is removed from every post, idea and content item of the organization and cannot be undone: { tagId }. |
buffer__mutate | Write — always a person | ONE Buffer mutation in Buffer's own format, for what the typed tools do not cover (content items across channels, post templates, snippets, promoting a draft): { mutation (one documented mutation field), variables?, a… |