API Status Get API Key

API Changelog

A running log of additions, changes, and deprecations to the Buffer GraphQL API.

June 16, 2026

Deprecated

  • PostMetricType.replies Description for enum value 'PostMetricType.replies' changed from 'Deprecated: not emitted by any per-network definition. Use `comments` instead — replies are normalized into `comments` on the networks that distinguish them (Threads). Will be removed on 2026-07-31.' to 'Deprecated: not emitted by any per-network definition. Use `comments` instead — replies are normalized into `comments` on the networks that distinguish them (Threads). Will be removed on 2026-12-01.'
  • PostMetricType.replies.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.replies.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.favorites Description for enum value 'PostMetricType.favorites' changed from 'Deprecated: not emitted by any per-network definition. Use `reactions` instead — Twitter and Mastodon favorites normalize into `reactions`. Will be removed on 2026-07-31.' to 'Deprecated: not emitted by any per-network definition. Use `reactions` instead — Twitter and Mastodon favorites normalize into `reactions`. Will be removed on 2026-12-01.'
  • PostMetricType.favorites.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.favorites.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.reblogs Description for enum value 'PostMetricType.reblogs' changed from 'Deprecated: not emitted by any per-network definition. Use `reposts` instead — Mastodon reblogs normalize into `reposts`. Will be removed on 2026-07-31.' to 'Deprecated: not emitted by any per-network definition. Use `reposts` instead — Mastodon reblogs normalize into `reposts`. Will be removed on 2026-12-01.'
  • PostMetricType.reblogs.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.reblogs.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.retweets Description for enum value 'PostMetricType.retweets' changed from 'Deprecated: not emitted by any per-network definition. Use `reposts` instead — Twitter retweets normalize into `reposts`. Will be removed on 2026-07-31.' to 'Deprecated: not emitted by any per-network definition. Use `reposts` instead — Twitter retweets normalize into `reposts`. Will be removed on 2026-12-01.'
  • PostMetricType.retweets.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.retweets.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.repins Description for enum value 'PostMetricType.repins' changed from 'Deprecated: not emitted by any per-network definition. Pre-normalization legacy from the Pinterest era. Will be removed on 2026-07-31.' to 'Deprecated: not emitted by any per-network definition. Pre-normalization legacy from the Pinterest era. Will be removed on 2026-12-01.'
  • PostMetricType.repins.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.repins.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.link_clicks Description for enum value 'PostMetricType.link_clicks' changed from 'Deprecated: StartPage link-clicks metric. StartPage is being deprecated as a product. Will be removed on 2026-07-31.' to 'Deprecated: StartPage link-clicks metric. StartPage is being deprecated as a product. Will be removed on 2026-12-01.'
  • PostMetricType.link_clicks.@deprecated Enum value 'PostMetricType.link_clicks' deprecation reason changed from 'StartPage is being deprecated as a product. Will be removed on 2026-07-31.' to 'StartPage is being deprecated as a product. Will be removed on 2026-12-01.'
  • PostMetricType.link_clicks.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.link_clicks.@deprecated.reason Argument 'reason' was added to '@deprecated'
  • PostMetricType.other Description for enum value 'PostMetricType.other' changed from 'Deprecated catch-all from pre-normalization. Never emitted. Will be removed on 2026-07-31.' to 'Deprecated catch-all from pre-normalization. Never emitted. Will be removed on 2026-12-01.'
  • PostMetricType.other.@deprecated.reason Argument 'reason' was removed from '@deprecated'
  • PostMetricType.other.@deprecated.reason Argument 'reason' was added to '@deprecated'

Added

Changed

  • PostMetricType.replies.@deprecated Enum value 'PostMetricType.replies' deprecation reason changed from 'Not emitted by any per-network definition; use `comments` instead. Will be removed on 2026-07-31.' to 'Not emitted by any per-network definition; use `comments` instead. Will be removed on 2026-12-01.'
  • PostMetricType.favorites.@deprecated Enum value 'PostMetricType.favorites' deprecation reason changed from 'Not emitted by any per-network definition; use `reactions` instead. Will be removed on 2026-07-31.' to 'Not emitted by any per-network definition; use `reactions` instead. Will be removed on 2026-12-01.'
  • PostMetricType.reblogs.@deprecated Enum value 'PostMetricType.reblogs' deprecation reason changed from 'Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-07-31.' to 'Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-12-01.'
  • PostMetricType.retweets.@deprecated Enum value 'PostMetricType.retweets' deprecation reason changed from 'Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-07-31.' to 'Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-12-01.'
  • PostMetricType.repins.@deprecated Enum value 'PostMetricType.repins' deprecation reason changed from 'Not emitted by any per-network definition. Will be removed on 2026-07-31.' to 'Not emitted by any per-network definition. Will be removed on 2026-12-01.'
  • PostMetricType.other.@deprecated Enum value 'PostMetricType.other' deprecation reason changed from 'Catch-all from pre-normalization; never emitted. Will be removed on 2026-07-31.' to 'Catch-all from pre-normalization; never emitted. Will be removed on 2026-12-01.'
  • ThreadedPostInput Description 'A post authored by the user which is posted to a thread. This is commonly used for long-format twitter and meta threads posts to allow authored content to span multiple threads. Threads are represented as a list of replies, each replying to the previous one.' on type 'ThreadedPostInput' has changed to 'A post authored by the user which is posted to a thread. This is commonly used for long-format twitter and meta threads posts to allow authored content to span multiple threads. Threads are represented as a list of replies, each replying to the previous one. The first item in the list is the root post of the thread and should match the top-level `text` on the post input; the remaining items are replies.'

June 11, 2026

Added

June 9, 2026

Deprecated

Added

  • PostMetricType 🧪 Preview Type 'PostMetricType' was added
  • PostMetricType.reactions Enum value 'reactions' was added to enum 'PostMetricType'
  • PostMetricType.reactions Description 'How many people reacted to your post. Unified across networks: Instagram/Twitter `likes`, Mastodon `favorites`, etc. all map to this value.' was added to enum value 'PostMetricType.reactions'
  • PostMetricType.comments Enum value 'comments' was added to enum 'PostMetricType'
  • PostMetricType.comments Description 'The count of comments and replies on your post. Unified across networks (Threads `replies` maps here).' was added to enum value 'PostMetricType.comments'
  • PostMetricType.shares Enum value 'shares' was added to enum 'PostMetricType'
  • PostMetricType.shares Description 'How many times your post was shared or forwarded by others.' was added to enum value 'PostMetricType.shares'
  • PostMetricType.reposts Enum value 'reposts' was added to enum 'PostMetricType'
  • PostMetricType.reposts Description 'How many times your post was reposted by others. Twitter `retweets`, Mastodon `reblogs`, Threads `reposts` all normalize to this value.' was added to enum value 'PostMetricType.reposts'
  • PostMetricType.reach Enum value 'reach' was added to enum 'PostMetricType'
  • PostMetricType.reach Description 'The number of unique people who saw your post.' was added to enum value 'PostMetricType.reach'
  • PostMetricType.impressions Enum value 'impressions' was added to enum 'PostMetricType'
  • PostMetricType.impressions Description 'How many times your post was shown on screen. May include multiple views by the same person — useful for spotting how often the content gets surfaced.' was added to enum value 'PostMetricType.impressions'
  • PostMetricType.views Enum value 'views' was added to enum 'PostMetricType'
  • PostMetricType.views Description 'How many times your post was viewed. Used for video-style posts and on networks that report views distinctly from impressions.' was added to enum value 'PostMetricType.views'
  • PostMetricType.clicks Enum value 'clicks' was added to enum 'PostMetricType'
  • PostMetricType.clicks Description 'How many times people clicked on your post.' was added to enum value 'PostMetricType.clicks'
  • PostMetricType.engagementRate Enum value 'engagementRate' was added to enum 'PostMetricType'
  • PostMetricType.engagementRate Description 'The percentage of people who interacted with your post compared to how many saw it. Unit: percentage.' was added to enum value 'PostMetricType.engagementRate'
  • PostMetricType.saves Enum value 'saves' was added to enum 'PostMetricType'
  • PostMetricType.saves Description 'How many times people saved your post (Instagram, Pinterest). A strong signal that the content is worth revisiting.' was added to enum value 'PostMetricType.saves'
  • PostMetricType.follows Enum value 'follows' was added to enum 'PostMetricType'
  • PostMetricType.follows Description 'The number of new followers gained from this post (Instagram).' was added to enum value 'PostMetricType.follows'
  • PostMetricType.quotes Enum value 'quotes' was added to enum 'PostMetricType'
  • PostMetricType.quotes Description 'How many times your post was quoted (Threads).' was added to enum value 'PostMetricType.quotes'
  • PostMetricType.viewers Enum value 'viewers' was added to enum 'PostMetricType'
  • PostMetricType.viewers Description 'Unique viewer count for video-style posts (LinkedIn).' was added to enum value 'PostMetricType.viewers'
  • PostMetricType.totalTimeWatched Enum value 'totalTimeWatched' was added to enum 'PostMetricType'
  • PostMetricType.totalTimeWatched Description 'Total time watched, in minutes, for video-style posts (LinkedIn).' was added to enum value 'PostMetricType.totalTimeWatched'
  • PostMetricType.likes Enum value 'likes' was added to enum 'PostMetricType'
  • PostMetricType.likes Description 'The Like-reaction subcount on Facebook. Distinct from `reactions` (which is the total of all reaction types — Like, Love, Care, Haha, Wow, Sad, Angry); Facebook\'s Graph API reports them separately and we mirror that.' was added to enum value 'PostMetricType.likes'
  • PostMetricType.postCount Enum value 'postCount' was added to enum 'PostMetricType'
  • PostMetricType.postCount Description 'The count of posts included in an aggregated response. Only meaningful on aggregate endpoints — never emitted per-post.' was added to enum value 'PostMetricType.postCount'
  • PostMetricType.replies Enum value 'replies' was added to enum 'PostMetricType'
  • PostMetricType.favorites Enum value 'favorites' was added to enum 'PostMetricType'
  • PostMetricType.reblogs Enum value 'reblogs' was added to enum 'PostMetricType'
  • PostMetricType.retweets Enum value 'retweets' was added to enum 'PostMetricType'
  • PostMetricType.repins Enum value 'repins' was added to enum 'PostMetricType'
  • PostMetricType.link_clicks Enum value 'link_clicks' was added to enum 'PostMetricType'
  • PostMetricType.other Enum value 'other' was added to enum 'PostMetricType'
  • PostMetricUnit 🧪 Preview Type 'PostMetricUnit' was added
  • PostMetricUnit.count Enum value 'count' was added to enum 'PostMetricUnit'
  • PostMetricUnit.count Description 'An integer count (e.g. number of reactions, impressions, reach).' was added to enum value 'PostMetricUnit.count'
  • PostMetricUnit.percentage Enum value 'percentage' was added to enum 'PostMetricUnit'
  • PostMetricUnit.percentage Description 'A percentage value between 0 and 100 (e.g. engagement rate).' was added to enum value 'PostMetricUnit.percentage'
  • PostMetric 🧪 Preview Type 'PostMetric' was added
  • PostMetric.type Field 'type' was added to object type 'PostMetric'
  • PostMetric.name Field 'name' was added to object type 'PostMetric'
  • PostMetric.displayName Field 'displayName' was added to object type 'PostMetric'
  • PostMetric.description Field 'description' was added to object type 'PostMetric'
  • PostMetric.value Field 'value' was added to object type 'PostMetric'
  • PostMetric.nullableValue Field 'nullableValue' was added to object type 'PostMetric'
  • PostMetric.unit Field 'unit' was added to object type 'PostMetric'
  • Post.metrics 🧪 Preview Field 'metrics' was added to object type 'Post'
  • Post.metricsUpdatedAt 🧪 Preview Field 'metricsUpdatedAt' was added to object type 'Post'

June 9, 2026

Added

Removed

June 9, 2026

Added

Removed

May 15, 2026

Added

May 12, 2026

Added

  • AssetInput Type 'AssetInput' was added
  • AssetInput.image Input field 'image' of type 'ImageAssetInput' was added to input object type 'AssetInput'
  • AssetInput.video Input field 'video' of type 'VideoAssetInput' was added to input object type 'AssetInput'
  • AssetInput.document Input field 'document' of type 'DocumentAssetInput' was added to input object type 'AssetInput'
  • AssetInput.link Input field 'link' of type 'LinkAssetInput' was added to input object type 'AssetInput'
  • AssetInput.@oneOf Directive 'oneOf' was added to input object 'AssetInput'

Removed

Changed

May 6, 2026

Added

Changed

April 22, 2026

Added

  • EditPostInput Type 'EditPostInput' was added
  • EditPostInput.id Input field 'id' of type 'PostId!' was added to input object type 'EditPostInput'
  • EditPostInput.schedulingType Input field 'schedulingType' of type 'SchedulingType!' was added to input object type 'EditPostInput'
  • EditPostInput.dueAt Input field 'dueAt' of type 'DateTime' was added to input object type 'EditPostInput'
  • EditPostInput.text Input field 'text' of type 'String' was added to input object type 'EditPostInput'
  • EditPostInput.metadata Input field 'metadata' of type 'PostInputMetaData' was added to input object type 'EditPostInput'
  • EditPostInput.tagIds Input field 'tagIds' of type '[TagId!]' was added to input object type 'EditPostInput'
  • EditPostInput.assets Input field 'assets' of type 'AssetsInput' was added to input object type 'EditPostInput'
  • EditPostInput.mode Input field 'mode' of type 'ShareMode!' was added to input object type 'EditPostInput'
  • EditPostInput.aiAssisted Input field 'aiAssisted' of type 'Boolean' was added to input object type 'EditPostInput'
  • EditPostInput.saveToDraft Input field 'saveToDraft' of type 'Boolean' was added to input object type 'EditPostInput'
  • Mutation.editPost Field 'editPost' was added to object type 'Mutation'
  • Mutation.editPost.input Argument 'input: EditPostInput!' added to field 'Mutation.editPost'

April 9, 2026

Changed

  • CreatePostInput Description 'Create post\'s request input.' on type 'CreatePostInput' has changed to 'Create post\'s request input. Note: `assets.videos` and `metadata.{service}.linkAttachment` are mutually exclusive. If both are provided, the video is ignored.'

March 16, 2026

Added

February 19, 2026

Added

February 17, 2026

Deprecated

Added

  • TagComparator Type 'TagComparator' was added
  • TagComparator.in Input field 'in' of type '[TagId!]!' was added to input object type 'TagComparator'
  • TagComparator.isEmpty Input field 'isEmpty' of type 'Boolean!' with default value 'false' was added to input object type 'TagComparator'
  • PostsFiltersInput.tags Input field 'tags' of type 'TagComparator' was added to input object type 'PostsFiltersInput'

February 3, 2026

Added

  • Organization 'Organization' object implements 'AccountOrganization' interface

Changed

  • Account.organizations Field 'Account.organizations' changed type from '[AccountOrganization!]!' to '[Organization!]!'
  • AccountOrganization 'AccountOrganization' kind changed from 'ObjectTypeDefinition' to 'InterfaceTypeDefinition'
  • OrganizationFilterInput Description 'Allow retrieving a specific AccountOrganization' on type 'OrganizationFilterInput' has changed to 'Allow retrieving a specific Organization'

January 28, 2026

Added

Removed