swagger: '2.0' schemes: - https host: api.bufferapp.com basePath: /1/ info: description: Social media management for marketers and agencies title: Bufferapp version: '1' externalDocs: url: 'https://buffer.com/developers/api' consumes: - application/json produces: - application/json securityDefinitions: oauth_2_0: authorizationUrl: 'https://bufferapp.com/oauth2/authorize' description: | Body example for authorisation request: client_id=...& redirect_uri=...& response_type=code Bidy example for token request: POST Data client_id=...& client_secret=...& redirect_uri=...& code=...& grant_type=authorization_code All 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. flow: accessCode scopes: {} tokenUrl: 'https://api.bufferapp.com/1/oauth2/token.json' type: oauth2 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: - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/configuration' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/links/shares{mediaTypeExtension}': get: description: Returns an object with a the numbers of shares a link has had using Buffer. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string - description: URL-encoded URL of the page for which the number of shares is requested. in: query name: url required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/shares' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/profiles/{id}/schedules/update{mediaTypeExtension}': post: consumes: - application/x-www-form-urlencoded description: | "Set the posting schedules for the specified social media profile. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/success' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '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 type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/schedules' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/profiles/{id}/updates/pending{mediaTypeExtension}': get: description: | "Returns an array of updates that are currently in the buffer for an individual social media profile. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true 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 type: integer - description: 'Specifies the number of status updates to receive. If provided, must be between 1 and 100.' in: query name: count type: integer - description: Specifies a unix timestamp which only status updates created after this time will be retrieved. format: date in: query name: since type: string - description: If utc is set times will be returned relative to UTC rather than the users associated timezone. in: query name: utc type: boolean responses: '200': description: OK schema: $ref: '#/definitions/updates-array' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/profiles/{id}/updates/reorder{mediaTypeExtension}': post: consumes: - application/x-www-form-urlencoded description: | Edit the order at which statuses for the specified social media profile will be sent out of the buffer. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/shuffle' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '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. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true 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 type: integer - description: 'Specifies the number of status updates to receive. If provided, must be between 1 and 100.' in: query name: count type: integer - description: Specifies a unix timestamp which only status updates created after this time will be retrieved. format: date in: query name: since type: string - description: If utc is set times will be returned relative to UTC rather than the users associated timezone. in: query name: utc type: boolean responses: '200': description: OK schema: $ref: '#/definitions/updates-array' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/profiles/{id}/updates/shuffle{mediaTypeExtension}': post: consumes: - application/x-www-form-urlencoded description: | Randomize the order at which statuses for the specified social media profile will be sent out of the buffer. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/shuffle' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: An unknown error occurred. '/profiles/{id}{mediaTypeExtension}': get: description: Returns details of the single specified social media profile. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string - in: path name: id required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/profile' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/profiles{mediaTypeExtension}': get: description: Returns an array of social media profiles connected to a users account. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/profiles' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/updates/create{mediaTypeExtension}': post: consumes: - application/x-www-form-urlencoded description: | Create one or more new status updates. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/newUpdate' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '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 type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/success' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '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. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string - 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. in: query name: event required: true 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 type: integer - description: 'Specifies the number of status updates to receive. If provided, must be between 1 and 100.' in: query name: count type: integer responses: '200': description: OK schema: $ref: '#/definitions/interactions' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/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 type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/update' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '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 type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/success' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: An unknown error occurred. '/updates/{id}/update{mediaTypeExtension}': post: consumes: - application/x-www-form-urlencoded description: | Edit an existing, individual status update. parameters: - in: path name: id required: true type: string - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/individual-update' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: An unknown error occurred. '/updates/{id}{mediaTypeExtension}': get: description: Returns a single social media update. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string - in: path name: id required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/update' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. '/user{mediaTypeExtension}': get: description: Returns a single user. parameters: - enum: - .json in: path name: mediaTypeExtension required: true type: string responses: '200': description: OK schema: $ref: '#/definitions/user' '400': description: | 1003 Parameter not recognized. 1004 Required parameter missing. 1006 Parameter value not within bounds. 1012 Profile did not save successfully. 1016 Profile buffer could not be emptied. 1022 Update did not save successfully. 1025 Update was recently posted, can't post duplicate content. 1026 Update must be in error status to requeue. 1027 Update must be in buffer and not custom scheduled in order to move to top. 1029 Event type not supported. 1030 Media filetype not supported. 1031 Media filesize out of acceptable range. 1032 Unable to post image to LinkedIn group(s). 1034 Cannot schedule updates in the past. 1033 Comments can only be posted to Facebook at this time. 1042 User did not save successfully. '403': description: | 403 Permission denied. 1001 Access token required. 1002 Not within application scope. 1011 No authorization to access profile. 1013 Profile schedule limit reached. 1014 Profile limit for user has been reached. 1015 Profile could not be destroyed. 1021 No authorization to access update. 1023 Update limit for profile has been reached. 1024 Update limit for team profile has been reached. 1028 Update soft limit for profile reached. 1051 No authorization to access client. '404': description: | 404 Endpoint not found. 1010 Profile could not be found. 1020 Update could not be found. 1050 Client could not be found. '405': description: | 405 Method not allowed. '406': description: | 1005 Unsupported response format. '500': description: | An unknown error occurred. definitions: 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