> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usereplier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List posts in Replier's calendar

> Lists the posts Replier publishes for the workspace whose time falls between start and end (default the next 31 days, at most 62), every draft without a time, and the next 10 posts still to go out. Posts made outside Replier are not listed.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/workspaces/{workspace_id}/scheduled-posts
openapi: 3.1.0
info:
  title: Replier API
  version: '1'
servers:
  - url: https://api.usereplier.com
security:
  - apiKey: []
paths:
  /v1/workspaces/{workspace_id}/scheduled-posts:
    get:
      tags:
        - Publishing
      summary: List posts in Replier's calendar
      description: >-
        Lists the posts Replier publishes for the workspace whose time falls
        between start and end (default the next 31 days, at most 62), every
        draft without a time, and the next 10 posts still to go out. Posts made
        outside Replier are not listed.
      operationId: list_scheduled_posts
      parameters:
        - name: workspace_id
          in: path
          required: true
          description: Workspace ID returned by `GET /v1/workspaces`
          schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        - name: start
          in: query
          required: false
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
        - name: end
          in: query
          required: false
          schema:
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspace:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                      name:
                        type: string
                      kind:
                        type: string
                        enum:
                          - personal
                          - agency
                      role:
                        type: string
                        enum:
                          - owner
                          - admin
                          - member
                    required:
                      - id
                      - name
                      - kind
                      - role
                  start:
                    type: string
                    format: date-time
                    pattern: >-
                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                  end:
                    type: string
                    format: date-time
                    pattern: >-
                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                  posts:
                    description: Posts whose publish or published time is in the range.
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        status:
                          description: >-
                            draft: saved, goes nowhere until scheduled or
                            published. scheduled: waits for publish_at. locked:
                            inside its last 3 minutes, being prepared; it can be
                            canceled but not edited. publishing: going out.
                            published: out on every channel. failed: a channel
                            failed; when another channel is published the post
                            is partly published, and channels[] says which.
                            canceled.
                          type: string
                          enum:
                            - draft
                            - scheduled
                            - locked
                            - publishing
                            - published
                            - failed
                            - canceled
                        media_type:
                          description: >-
                            Decided by the files: one photo, one video (a Reel),
                            or 2-20.
                          type: string
                          enum:
                            - image
                            - carousel
                            - reels
                        caption:
                          description: The post's caption.
                          type: string
                        first_comment:
                          description: >-
                            Commented on the post right after it publishes,
                            once.
                          type:
                            - string
                            - 'null'
                        media:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              kind:
                                type: string
                                enum:
                                  - image
                                  - video
                              url:
                                type: string
                                format: uri
                              width:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              height:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              bytes:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              duration_ms:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              cover_image_id:
                                description: >-
                                  A Reel's cover image; null shows the frame a
                                  second in.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - kind
                              - url
                              - width
                              - height
                              - bytes
                              - duration_ms
                              - cover_image_id
                        media_removed:
                          description: >-
                            Replier deleted the post's files after their
                            retention, so it can't be edited or published again.
                          type: boolean
                        publish_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        time_zone:
                          type: string
                        automation_id:
                          description: >-
                            The automation that answers the post's comments once
                            it is published.
                          anyOf:
                            - type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                            - type: 'null'
                        channels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              channel:
                                type: string
                                enum:
                                  - instagram
                                  - facebook
                              account_id:
                                type: string
                              account_name:
                                type:
                                  - string
                                  - 'null'
                              account_connected:
                                description: >-
                                  False once the account was disconnected from
                                  the workspace; a draft keeps it, but
                                  scheduling or publishing needs it connected
                                  again.
                                type: boolean
                              status:
                                description: >-
                                  paused: its account was disconnected before
                                  the post was due; it resumes if the same
                                  account reconnects in time, and fails at the
                                  post's time otherwise.
                                type: string
                                enum:
                                  - pending
                                  - publishing
                                  - published
                                  - failed
                                  - paused
                              permalink:
                                type:
                                  - string
                                  - 'null'
                              published_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              publish_unconfirmed:
                                description: >-
                                  Replier asked Meta to publish and is still
                                  finding out whether it did. Don't publish it
                                  again meanwhile.
                                type: boolean
                              error_code:
                                description: >-
                                  Why the channel failed or waits, such as
                                  publish_permission_required,
                                  channel_disconnected, plan_required,
                                  publishing_disabled or container_error.
                                type:
                                  - string
                                  - 'null'
                              error_message:
                                type:
                                  - string
                                  - 'null'
                              failed_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              first_comment_error:
                                type:
                                  - string
                                  - 'null'
                              automation_error:
                                description: >-
                                  Set when the post published but its automation
                                  couldn't be attached.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - channel
                              - account_id
                              - account_name
                              - account_connected
                              - status
                              - permalink
                              - published_at
                              - publish_unconfirmed
                              - error_code
                              - error_message
                              - failed_at
                              - first_comment_error
                              - automation_error
                        published_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        failed_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        locked:
                          description: >-
                            Inside its last 3 minutes or publishing: it can be
                            canceled until Meta is asked to publish it, but not
                            edited.
                          type: boolean
                        version:
                          description: >-
                            Pass as version to `PATCH
                            /v1/workspaces/{workspace_id}/scheduled-posts/{post_id}`.
                          type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        updated_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                      required:
                        - id
                        - status
                        - media_type
                        - caption
                        - first_comment
                        - media
                        - media_removed
                        - publish_at
                        - time_zone
                        - automation_id
                        - channels
                        - published_at
                        - failed_at
                        - locked
                        - version
                        - created_at
                        - updated_at
                  drafts:
                    description: Drafts without a time, newest edit first, up to 50.
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        status:
                          description: >-
                            draft: saved, goes nowhere until scheduled or
                            published. scheduled: waits for publish_at. locked:
                            inside its last 3 minutes, being prepared; it can be
                            canceled but not edited. publishing: going out.
                            published: out on every channel. failed: a channel
                            failed; when another channel is published the post
                            is partly published, and channels[] says which.
                            canceled.
                          type: string
                          enum:
                            - draft
                            - scheduled
                            - locked
                            - publishing
                            - published
                            - failed
                            - canceled
                        media_type:
                          description: >-
                            Decided by the files: one photo, one video (a Reel),
                            or 2-20.
                          type: string
                          enum:
                            - image
                            - carousel
                            - reels
                        caption:
                          description: The post's caption.
                          type: string
                        first_comment:
                          description: >-
                            Commented on the post right after it publishes,
                            once.
                          type:
                            - string
                            - 'null'
                        media:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              kind:
                                type: string
                                enum:
                                  - image
                                  - video
                              url:
                                type: string
                                format: uri
                              width:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              height:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              bytes:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              duration_ms:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              cover_image_id:
                                description: >-
                                  A Reel's cover image; null shows the frame a
                                  second in.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - kind
                              - url
                              - width
                              - height
                              - bytes
                              - duration_ms
                              - cover_image_id
                        media_removed:
                          description: >-
                            Replier deleted the post's files after their
                            retention, so it can't be edited or published again.
                          type: boolean
                        publish_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        time_zone:
                          type: string
                        automation_id:
                          description: >-
                            The automation that answers the post's comments once
                            it is published.
                          anyOf:
                            - type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                            - type: 'null'
                        channels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              channel:
                                type: string
                                enum:
                                  - instagram
                                  - facebook
                              account_id:
                                type: string
                              account_name:
                                type:
                                  - string
                                  - 'null'
                              account_connected:
                                description: >-
                                  False once the account was disconnected from
                                  the workspace; a draft keeps it, but
                                  scheduling or publishing needs it connected
                                  again.
                                type: boolean
                              status:
                                description: >-
                                  paused: its account was disconnected before
                                  the post was due; it resumes if the same
                                  account reconnects in time, and fails at the
                                  post's time otherwise.
                                type: string
                                enum:
                                  - pending
                                  - publishing
                                  - published
                                  - failed
                                  - paused
                              permalink:
                                type:
                                  - string
                                  - 'null'
                              published_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              publish_unconfirmed:
                                description: >-
                                  Replier asked Meta to publish and is still
                                  finding out whether it did. Don't publish it
                                  again meanwhile.
                                type: boolean
                              error_code:
                                description: >-
                                  Why the channel failed or waits, such as
                                  publish_permission_required,
                                  channel_disconnected, plan_required,
                                  publishing_disabled or container_error.
                                type:
                                  - string
                                  - 'null'
                              error_message:
                                type:
                                  - string
                                  - 'null'
                              failed_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              first_comment_error:
                                type:
                                  - string
                                  - 'null'
                              automation_error:
                                description: >-
                                  Set when the post published but its automation
                                  couldn't be attached.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - channel
                              - account_id
                              - account_name
                              - account_connected
                              - status
                              - permalink
                              - published_at
                              - publish_unconfirmed
                              - error_code
                              - error_message
                              - failed_at
                              - first_comment_error
                              - automation_error
                        published_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        failed_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        locked:
                          description: >-
                            Inside its last 3 minutes or publishing: it can be
                            canceled until Meta is asked to publish it, but not
                            edited.
                          type: boolean
                        version:
                          description: >-
                            Pass as version to `PATCH
                            /v1/workspaces/{workspace_id}/scheduled-posts/{post_id}`.
                          type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        updated_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                      required:
                        - id
                        - status
                        - media_type
                        - caption
                        - first_comment
                        - media
                        - media_removed
                        - publish_at
                        - time_zone
                        - automation_id
                        - channels
                        - published_at
                        - failed_at
                        - locked
                        - version
                        - created_at
                        - updated_at
                  upcoming:
                    description: The next 10 posts still to go out, soonest first.
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        status:
                          description: >-
                            draft: saved, goes nowhere until scheduled or
                            published. scheduled: waits for publish_at. locked:
                            inside its last 3 minutes, being prepared; it can be
                            canceled but not edited. publishing: going out.
                            published: out on every channel. failed: a channel
                            failed; when another channel is published the post
                            is partly published, and channels[] says which.
                            canceled.
                          type: string
                          enum:
                            - draft
                            - scheduled
                            - locked
                            - publishing
                            - published
                            - failed
                            - canceled
                        media_type:
                          description: >-
                            Decided by the files: one photo, one video (a Reel),
                            or 2-20.
                          type: string
                          enum:
                            - image
                            - carousel
                            - reels
                        caption:
                          description: The post's caption.
                          type: string
                        first_comment:
                          description: >-
                            Commented on the post right after it publishes,
                            once.
                          type:
                            - string
                            - 'null'
                        media:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              kind:
                                type: string
                                enum:
                                  - image
                                  - video
                              url:
                                type: string
                                format: uri
                              width:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              height:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              bytes:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              duration_ms:
                                anyOf:
                                  - type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                  - type: 'null'
                              cover_image_id:
                                description: >-
                                  A Reel's cover image; null shows the frame a
                                  second in.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - kind
                              - url
                              - width
                              - height
                              - bytes
                              - duration_ms
                              - cover_image_id
                        media_removed:
                          description: >-
                            Replier deleted the post's files after their
                            retention, so it can't be edited or published again.
                          type: boolean
                        publish_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        time_zone:
                          type: string
                        automation_id:
                          description: >-
                            The automation that answers the post's comments once
                            it is published.
                          anyOf:
                            - type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                            - type: 'null'
                        channels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              channel:
                                type: string
                                enum:
                                  - instagram
                                  - facebook
                              account_id:
                                type: string
                              account_name:
                                type:
                                  - string
                                  - 'null'
                              account_connected:
                                description: >-
                                  False once the account was disconnected from
                                  the workspace; a draft keeps it, but
                                  scheduling or publishing needs it connected
                                  again.
                                type: boolean
                              status:
                                description: >-
                                  paused: its account was disconnected before
                                  the post was due; it resumes if the same
                                  account reconnects in time, and fails at the
                                  post's time otherwise.
                                type: string
                                enum:
                                  - pending
                                  - publishing
                                  - published
                                  - failed
                                  - paused
                              permalink:
                                type:
                                  - string
                                  - 'null'
                              published_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              publish_unconfirmed:
                                description: >-
                                  Replier asked Meta to publish and is still
                                  finding out whether it did. Don't publish it
                                  again meanwhile.
                                type: boolean
                              error_code:
                                description: >-
                                  Why the channel failed or waits, such as
                                  publish_permission_required,
                                  channel_disconnected, plan_required,
                                  publishing_disabled or container_error.
                                type:
                                  - string
                                  - 'null'
                              error_message:
                                type:
                                  - string
                                  - 'null'
                              failed_at:
                                anyOf:
                                  - type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  - type: 'null'
                              first_comment_error:
                                type:
                                  - string
                                  - 'null'
                              automation_error:
                                description: >-
                                  Set when the post published but its automation
                                  couldn't be attached.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - channel
                              - account_id
                              - account_name
                              - account_connected
                              - status
                              - permalink
                              - published_at
                              - publish_unconfirmed
                              - error_code
                              - error_message
                              - failed_at
                              - first_comment_error
                              - automation_error
                        published_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        failed_at:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                            - type: 'null'
                        locked:
                          description: >-
                            Inside its last 3 minutes or publishing: it can be
                            canceled until Meta is asked to publish it, but not
                            edited.
                          type: boolean
                        version:
                          description: >-
                            Pass as version to `PATCH
                            /v1/workspaces/{workspace_id}/scheduled-posts/{post_id}`.
                          type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        updated_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                      required:
                        - id
                        - status
                        - media_type
                        - caption
                        - first_comment
                        - media
                        - media_removed
                        - publish_at
                        - time_zone
                        - automation_id
                        - channels
                        - published_at
                        - failed_at
                        - locked
                        - version
                        - created_at
                        - updated_at
                required:
                  - workspace
                  - start
                  - end
                  - posts
                  - drafts
                  - upcoming
        default:
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: Refused
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: object
                required:
                  - code
                  - message
                properties:
                  code:
                    type: string
                    description: >-
                      Why the request was refused, such as AUTOMATION_NOT_FOUND
                      or VERSION_CONFLICT. Other fields beside it give details.
                  message:
                    type: string
                    description: The same reason, in English.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: A Replier API key (rpl_...).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.