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

# Resume interrupted publishing

> Resume an interrupted account's unpublished posts using its current version. Confirm the account and remaining content with the user. Published posts are preserved; uncertain results cannot be resumed. Reuse the same idempotencyKey for retries.

Write access: a member/administrator with a write-enabled credential, or an authorized signed-in user.

Resume an interrupted account's unpublished posts using its current version. Confirm the account and remaining content with the user. Published posts are preserved; uncertain results cannot be resumed. Reuse the same idempotencyKey for retries.

Resume one connected account's failed remainder without creating a new posting group. Confirmed posts, their IDs and original request key are preserved. Active, cancelled or uncertain sequences cannot be resumed. Reuse the same resume key and payload after a lost response. A new failure requires a new key and the latest group version.

MCP clients can use [`resume_post`](/mcp-reference/resume_post) for this operation.

[Request conventions](/api-reference/overview) · [API keys](/api-keys) · [MCP connections](/mcp-connections)


## OpenAPI

````yaml api-reference/openapi.json POST /api/posts/{postId}/resume
openapi: 3.1.0
info:
  title: Posted HTTP API
  version: 0.2.3
  description: >-
    All registered application, account, OAuth, MCP transport and health
    endpoints. Publishing and draft request schemas come from the shared runtime
    validators. Replace the example server with your installation. Documentation
    uses simple request examples and does not execute live publishing requests.
servers:
  - url: https://posted-api.example.com
security: []
paths:
  /api/posts/{postId}/resume:
    post:
      tags:
        - Posts
      summary: Resume interrupted publishing
      description: >-
        Resume an interrupted account's unpublished posts using its current
        version. Confirm the account and remaining content with the user.
        Published posts are preserved; uncertain results cannot be resumed.
        Reuse the same idempotencyKey for retries.


        Resume one connected account's failed remainder without creating a new
        posting group. Confirmed posts, their IDs and original request key are
        preserved. Active, cancelled or uncertain sequences cannot be resumed.
        Reuse the same resume key and payload after a lost response. A new
        failure requires a new key and the latest group version.


        Write access: a member/administrator with a write-enabled credential, or
        an authorized signed-in user.
      operationId: post_api_posts_by_postId_resume
      parameters:
        - name: postId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The postId from the corresponding list, record or authorization
            response.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                connectionId:
                  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)$
                version:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                idempotencyKey:
                  type: string
                  pattern: ^[A-Za-z0-9._:-]{8,128}$
              required:
                - connectionId
                - version
                - idempotencyKey
              additionalProperties: false
            example:
              connectionId: 11111111-1111-4111-8111-111111111111
              version: 1
              idempotencyKey: studio-resume-2027-01-18
      responses:
        '200':
          description: >-
            Successful response. Examples are illustrative; field values vary by
            record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  post:
                    type: object
                    properties:
                      resumableConnectionIds:
                        type: array
                        items: {}
                      id:
                        type: string
                      text:
                        type: string
                      additionalPosts:
                        type: array
                        items: {}
                      mediaOverrides:
                        type: object
                        properties: {}
                        additionalProperties: true
                      scheduledAt:
                        type: string
                      idempotencyKey:
                        type: string
                      state:
                        type: string
                      version:
                        type: integer
                      createdAt:
                        type: string
                      media:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            fileName:
                              type: string
                            contentType:
                              type: string
                            sizeBytes:
                              type: integer
                            width:
                              type: integer
                            height:
                              type: integer
                            alt:
                              type: string
                            durationSeconds:
                              type:
                                - string
                                - 'null'
                          additionalProperties: true
                      managedBy:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          avatarUrl:
                            type:
                              - string
                              - 'null'
                        additionalProperties: true
                      deliveries:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            postIndex:
                              type: integer
                            connectionId:
                              type: string
                            provider:
                              type: string
                            accountName:
                              type: string
                            accountHandle:
                              type: string
                            textOverride:
                              type:
                                - string
                                - 'null'
                            state:
                              type: string
                            attempts:
                              type: integer
                            nextAttemptAt:
                              type:
                                - string
                                - 'null'
                            providerPostId:
                              type:
                                - string
                                - 'null'
                            publishedUrl:
                              type:
                                - string
                                - 'null'
                            error:
                              type:
                                - string
                                - 'null'
                            publishedAt:
                              type:
                                - string
                                - 'null'
                          additionalProperties: true
                    additionalProperties: true
                additionalProperties: true
              example:
                post:
                  resumableConnectionIds: []
                  id: 22222222-2222-4222-8222-222222222222
                  text: A small update from the studio.
                  additionalPosts: []
                  mediaOverrides: {}
                  scheduledAt: '2027-01-18T09:30:00.000Z'
                  idempotencyKey: studio-update-2027-01-18
                  state: scheduled
                  version: 2
                  createdAt: '2027-01-18T09:30:00.000Z'
                  media:
                    - id: 44444444-4444-4444-8444-444444444444
                      fileName: studio.jpg
                      contentType: image/jpeg
                      sizeBytes: 245760
                      width: 1600
                      height: 900
                      alt: A bright studio desk beside a window
                      durationSeconds: null
                  managedBy:
                    id: 66666666-6666-4666-8666-666666666666
                    name: Alex Morgan
                    avatarUrl: null
                  deliveries:
                    - id: 77777777-7777-4777-8777-777777777777
                      postIndex: 0
                      connectionId: 11111111-1111-4111-8111-111111111111
                      provider: bluesky
                      accountName: Alex Morgan
                      accountHandle: alex.example.test
                      textOverride: null
                      state: scheduled
                      attempts: 0
                      nextAttemptAt: null
                      providerPostId: null
                      publishedUrl: null
                      error: null
                      publishedAt: null
        default:
          description: >-
            Request failure. Inspect code, message and requestId; respect
            Retry-After on HTTP 429.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal or team Posted REST API key
    sessionCookie:
      type: apiKey
      in: cookie
      name: posted_session
      description: >-
        Signed-in human browser session; mutation requests also need the exact
        UI Origin

````

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