swagger: "2.0"
schemes:
  - https
host: api.bufferapp.com
basePath: /1/
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
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
