{"openapi":"3.0.0","info":{"description":"Social media management for marketers and agencies","title":"Bufferapp","version":"1","x-apisguru-categories":["social","marketing"],"x-logo":{"url":"https://d389zggrogs7qo.cloudfront.net/images/app/buffer-logo@2x.png"},"x-origin":[{"format":"swagger","url":"https://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/bufferapp.com/1/swagger.yaml","version":"2.0"}],"x-providerName":"bufferapp.com","x-unofficialSpec":true},"externalDocs":{"url":"https://buffer.com/developers/api"},"paths":{"/info/configuration{mediaTypeExtension}":{"get":{"description":"Returns an object with the current configuration that Buffer is using, including supported services, their icons and the varying limits of character and schedules.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/configuration"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/links/shares{mediaTypeExtension}":{"get":{"description":"Returns an object with a the numbers of shares a link has had using Buffer.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"description":"URL-encoded URL of the page for which the number of shares is requested.","in":"query","name":"url","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/shares"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/profiles/{id}/schedules/update{mediaTypeExtension}":{"post":{"description":"\"Set the posting schedules for the specified social media profile.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/success"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/profiles/{id}/schedules{mediaTypeExtension}":{"get":{"description":"Returns details of the posting schedules associated with a social media profile.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/schedules"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/profiles/{id}/updates/pending{mediaTypeExtension}":{"get":{"description":"\"Returns an array of updates that are currently in the buffer for an individual social media profile.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"description":"Specifies the page of status updates to receive. If not specified the first page of results will be returned.","in":"query","name":"page","schema":{"type":"integer"}},{"description":"Specifies the number of status updates to receive. If provided, must be between 1 and 100.","in":"query","name":"count","schema":{"type":"integer"}},{"description":"Specifies a unix timestamp which only status updates created after this time will be retrieved.","in":"query","name":"since","schema":{"type":"string","format":"date"}},{"description":"If utc is set times will be returned relative to UTC rather than the users associated timezone.","in":"query","name":"utc","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updates-array"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/profiles/{id}/updates/reorder{mediaTypeExtension}":{"post":{"description":"Edit the order at which statuses for the specified social media profile will be sent out of the buffer.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/shuffle"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/profiles/{id}/updates/sent{mediaTypeExtension}":{"get":{"description":"Returns an array of updates that have been sent from the buffer for an individual social media profile.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"description":"Specifies the page of status updates to receive. If not specified the first page of results will be returned.","in":"query","name":"page","schema":{"type":"integer"}},{"description":"Specifies the number of status updates to receive. If provided, must be between 1 and 100.","in":"query","name":"count","schema":{"type":"integer"}},{"description":"Specifies a unix timestamp which only status updates created after this time will be retrieved.","in":"query","name":"since","schema":{"type":"string","format":"date"}},{"description":"If utc is set times will be returned relative to UTC rather than the users associated timezone.","in":"query","name":"utc","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updates-array"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/profiles/{id}/updates/shuffle{mediaTypeExtension}":{"post":{"description":"Randomize the order at which statuses for the specified social media profile will be sent out of the buffer.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/shuffle"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/profiles/{id}{mediaTypeExtension}":{"get":{"description":"Returns details of the single specified social media profile.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/profile"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/profiles{mediaTypeExtension}":{"get":{"description":"Returns an array of social media profiles connected to a users account.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/profiles"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/updates/create{mediaTypeExtension}":{"post":{"description":"Create one or more new status updates.\n","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/newUpdate"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/updates/{id}/destroy{mediaTypeExtension}":{"post":{"description":"Permanently delete an existing status update.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/success"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/updates/{id}/interactions{mediaTypeExtension}":{"get":{"description":"Returns the detailed information on individual interactions with the social media update such as favorites, retweets and likes.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"description":"Specifies a type of event to be retrieved, for example \"retweet\", \"like\", \"comment\", \"mention\" or \"reshare\". They can also be plural (e.g., \"reshares\"). Plurality has no effect other than visual semantics. See /info/configuration for more information on supported interaction events.\n","in":"query","name":"event","required":true,"schema":{"type":"string"}},{"description":"Specifies the page of status updates to receive. If not specified the first page of results will be returned.","in":"query","name":"page","schema":{"type":"integer"}},{"description":"Specifies the number of status updates to receive. If provided, must be between 1 and 100.","in":"query","name":"count","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/interactions"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/updates/{id}/move_to_top{mediaTypeExtension}":{"post":{"description":"Move an existing status update to the top of the queue and recalculate times for all updates in the queue. Returns the update with its new posting time.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/update"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/updates/{id}/share{mediaTypeExtension}":{"post":{"description":"Immediately shares a single pending update and recalculates times for updates remaining in the queue.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/success"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/updates/{id}/update{mediaTypeExtension}":{"post":{"description":"Edit an existing, individual status update.\n","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/individual-update"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred."}}}},"/updates/{id}{mediaTypeExtension}":{"get":{"description":"Returns a single social media update.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}},{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/update"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}},"/user{mediaTypeExtension}":{"get":{"description":"Returns a single user.","parameters":[{"in":"path","name":"mediaTypeExtension","required":true,"schema":{"type":"string","enum":[".json"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/user"}}}},"400":{"description":"1003  Parameter not recognized.\n1004  Required parameter missing.\n1006  Parameter value not within bounds.\n1012  Profile did not save successfully.\n1016  Profile buffer could not be emptied.\n1022  Update did not save successfully.\n1025  Update was recently posted, can't post duplicate content.\n1026  Update must be in error status to requeue.\n1027  Update must be in buffer and not custom scheduled in order to move to top.\n1029  Event type not supported.\n1030  Media filetype not supported.\n1031  Media filesize out of acceptable range.\n1032  Unable to post image to LinkedIn group(s).\n1034  Cannot schedule updates in the past.\n1033  Comments can only be posted to Facebook at this time.\n1042  User did not save successfully.\n"},"403":{"description":"403  Permission denied.\n1001  Access token required.\n1002  Not within application scope.\n1011  No authorization to access profile.\n1013  Profile schedule limit reached.\n1014  Profile limit for user has been reached.\n1015  Profile could not be destroyed.\n1021  No authorization to access update.\n1023  Update limit for profile has been reached.\n1024  Update limit for team profile has been reached.\n1028  Update soft limit for profile reached.\n1051  No authorization to access client.\n"},"404":{"description":"404  Endpoint not found.\n1010  Profile could not be found.\n1020  Update could not be found.\n1050  Client could not be found.\n"},"405":{"description":"405  Method not allowed.\n"},"406":{"description":"1005  Unsupported response format.\n"},"500":{"description":"An unknown error occurred.\n"}}}}},"servers":[{"url":"https://api.bufferapp.com/1"}],"components":{"securitySchemes":{"oauth_2_0":{"description":"Body example for authorisation request:\n\nclient_id=...&\nredirect_uri=...&\nresponse_type=code\n\nBidy example for token request:\n\nPOST Data\nclient_id=...&\nclient_secret=...&\nredirect_uri=...&\ncode=...&\ngrant_type=authorization_code\n\nAll requests to the Buffer API must be made using HTTPS, with the access token provided in the HTTP Authorization header, request body or query string.\n","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://bufferapp.com/oauth2/authorize","tokenUrl":"https://api.bufferapp.com/1/oauth2/token.json","scopes":{}}}}},"schemas":{"configuration":{"properties":{"media":{"properties":{"picture_filetypes":{"items":{"type":"string"},"type":"array"},"picture_size_max":{"type":"number"},"picture_size_min":{"type":"number"}},"type":"object"},"services":{"properties":{"appdotnet":{"properties":{"types":{"properties":{"profile":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{},"type":"array"}},"type":"object"}},"type":"object"},"urls":{"properties":{"hashtag":{"type":"string"},"user":{"type":"string"}},"type":"object"}},"type":"object"},"facebook":{"properties":{"types":{"properties":{"group":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"page":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"profile":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"type":"object"},"urls":{"properties":{"user":{"type":"string"}},"type":"object"}},"type":"object"},"google":{"properties":{"types":{"properties":{"page":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"profile":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"type":"object"},"urls":{"properties":{"user":{"type":"string"}},"type":"object"}},"type":"object"},"linkedin":{"properties":{"types":{"properties":{"group":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"page":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"profile":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"type":"object"},"urls":{"properties":{"user":{"type":"string"}},"type":"object"}},"type":"object"},"twitter":{"properties":{"types":{"properties":{"profile":{"properties":{"character_limit":{"type":"number"},"icons":{"properties":{"16":{"type":"string"},"32":{"type":"string"},"64":{"type":"string"}},"type":"object"},"link_attachments":{"type":"boolean"},"name":{"type":"string"},"schedule_limit":{"type":"number"},"supported_interactions":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"type":"object"},"urls":{"properties":{"cashtag":{"type":"string"},"hashtag":{"type":"string"},"user":{"type":"string"}},"type":"object"}},"type":"object"}},"type":"object"}},"type":"object"},"individual-update":{"properties":{"buffer_count":{"type":"number"},"buffer_percentage":{"type":"number"},"success":{"type":"boolean"},"update":{"properties":{"client_id":{"type":"string"},"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"media":{"properties":{"description":{"type":"string"},"link":{"type":"string"},"title":{"type":"string"}},"type":"object"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"}},"type":"object"},"interactions":{"properties":{"interactions":{"items":{"properties":{"_id":{"type":"string"},"created_at":{"type":"number"},"event":{"type":"string"},"id":{"type":"string"},"interaction_id":{"type":"string"},"user":{"properties":{"avatar":{"type":"string"},"avatar_https":{"type":"string"},"followers":{"type":"number"},"twitter_id":{"type":"string"},"username":{"type":"string"}},"type":"object"}},"type":"object"},"type":"array"},"total":{"type":"number"}},"type":"object"},"newUpdate":{"properties":{"buffer_count":{"type":"number"},"buffer_percentage":{"type":"number"},"success":{"type":"boolean"},"updates":{"items":{"properties":{"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"media":{"properties":{"description":{"type":"string"},"link":{"type":"string"},"title":{"type":"string"}},"type":"object"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"profile":{"properties":{"avatar":{"type":"string"},"created_at":{"type":"number"},"default":{"type":"boolean"},"formatted_username":{"type":"string"},"id":{"type":"string"},"schedules":{"items":{"properties":{"days":{"items":{"type":"string"},"type":"array"},"times":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"service":{"type":"string"},"service_id":{"type":"string"},"service_username":{"type":"string"},"statistics":{"properties":{"followers":{"type":"number"}},"type":"object"},"team_members":{"items":{"type":"string"},"type":"array"},"timezone":{"type":"string"},"user_id":{"type":"string"}},"type":"object"},"profiles":{"items":{"properties":{"_id":{"type":"string"},"avatar":{"type":"string"},"avatar_https":{"type":"string"},"counts":{"properties":{"daily_suggestions":{"type":"number"},"drafts":{"type":"number"},"pending":{"type":"number"},"sent":{"type":"number"}},"type":"object"},"cover_photo":{"type":"string"},"default":{"type":"boolean"},"disabled_features":{"items":{},"type":"array"},"disconnected":{"type":"string"},"formatted_service":{"type":"string"},"formatted_username":{"type":"string"},"has_used_suggestions":{"type":"boolean"},"id":{"type":"string"},"schedules":{"items":{"properties":{"days":{"items":{"type":"string"},"type":"array"},"times":{"items":{},"type":"array"}},"type":"object"},"type":"array"},"service":{"type":"string"},"service_id":{"type":"string"},"service_type":{"type":"string"},"service_username":{"type":"string"},"shortener":{"properties":{"domain":{"type":"string"}},"type":"object"},"statistics":{"properties":{"connections":{"type":"number"}},"type":"object"},"timezone":{"type":"string"},"user_id":{"type":"string"},"utm_tracking":{"type":"string"},"verb":{"type":"string"}},"type":"object"},"type":"array"},"reorder":{"properties":{"success":{"type":"boolean"},"updates":{"items":{"properties":{"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"schedules":{"properties":{"days":{"items":{"type":"string"},"type":"array"},"times":{"items":{"type":"string"},"type":"array"}},"type":"object"},"schedules-update":{"properties":{"success":{"type":"boolean"}},"type":"object"},"share":{"properties":{"success":{"type":"boolean"}},"type":"object"},"shares":{"properties":{"shares":{"type":"number"}},"type":"object"},"shuffle":{"properties":{"success":{"type":"boolean"},"updates":{"items":{"properties":{"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"success":{"properties":{"success":{"type":"boolean"}},"type":"object"},"update":{"properties":{"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"sent_at":{"type":"number"},"service_update_id":{"type":"string"},"statistics":{"properties":{"clicks":{"type":"number"},"favorites":{"type":"number"},"mentions":{"type":"number"},"reach":{"type":"number"},"retweets":{"type":"number"}},"type":"object"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"},"updates-array":{"properties":{"total":{"type":"number"},"updates":{"items":{"properties":{"created_at":{"type":"number"},"day":{"type":"string"},"due_at":{"type":"number"},"due_time":{"type":"string"},"id":{"type":"string"},"profile_id":{"type":"string"},"profile_service":{"type":"string"},"status":{"type":"string"},"text":{"type":"string"},"text_formatted":{"type":"string"},"user_id":{"type":"string"},"via":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"user":{"properties":{"_id":{"type":"string"},"activity_at":{"type":"number"},"created_at":{"type":"number"},"id":{"type":"string"},"plan":{"type":"string"},"referral_link":{"type":"string"},"referral_token":{"type":"string"},"secret_email":{"type":"string"},"timezone":{"type":"string"}},"type":"object"}}}}