OpenPost Repost Automation API

The Repost Automation API from OpenPost — 2 operation(s) for repost automation.

GitHub OpenAPI

Operations 3

DELETE /repost-account-grants/{grant_id} Revoke a cross-workspace repost account grant #
GET /repost-automation Get workspace repost rules and available accounts #
PUT /repost-automation Replace workspace repost rules #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-repost-automation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openpo-st-repost-automation-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: hello@openpo.st
    name: OpenPost support
    url: https://openpo.st/contact
  description: OpenPost HTTP API for workspace-scoped social publishing. Use it to inspect accounts and provider readiness, manage media and publications, schedule work, and read publishing results. Every operation still follows token scopes, workspace roles, plan limits, provider capabilities, and destination validation.
  license:
    identifier: AGPL-3.0-only
    name: AGPL-3.0-only
  termsOfService: https://openpo.st/terms
  title: OpenPost Repost Automation API
  version: 1.0.0
servers:
- description: OpenPost Hosted service
  url: https://app.openpo.st/api/v1
- description: The OpenPost instance serving this contract
  url: /api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:
- name: Repost Automation
paths:
  /repost-account-grants/{grant_id}:
    delete:
      operationId: revoke-repost-account-grant
      parameters:
      - description: Grant ID
        in: path
        name: grant_id
        required: true
        schema:
          description: Grant ID
          type: string
      - description: Workspace requesting revocation
        explode: false
        in: query
        name: workspace_id
        required: true
        schema:
          description: Workspace requesting revocation
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepostGrantOutputBody'
          description: OK
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Revoke a cross-workspace repost account grant
      tags:
      - Repost Automation
  /repost-automation:
    get:
      operationId: get-repost-automation
      parameters:
      - description: Workspace ID
        explode: false
        in: query
        name: workspace_id
        required: true
        schema:
          description: Workspace ID
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsResponse'
          description: OK
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Get workspace repost rules and available accounts
      tags:
      - Repost Automation
      x-openpost-automation:
        access: read
        effect: query
        exposure: alpha
        idempotency: none
        retry: transient
        selectors:
        - label_path: name
          operation_id: list-workspaces
          parameter: workspace_id
          value_path: id
    put:
      operationId: save-repost-automation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveRepostSettingsInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsResponse'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Replace workspace repost rules
      tags:
      - Repost Automation
components:
  schemas:
    StageHistoryEntry:
      additionalProperties: false
      properties:
        delay_seconds:
          format: int64
          type: integer
        executed_at:
          format: date-time
          type: string
        external_url:
          type: string
        repost_external_id:
          type: string
        stage:
          format: int64
          type: integer
        unrepost_previous:
          type: boolean
        unreposted_at:
          format: date-time
          type: string
      required:
      - stage
      - delay_seconds
      - unrepost_previous
      - executed_at
      type: object
    AccountOption:
      additionalProperties: false
      properties:
        avatar_url:
          type: string
        cross_workspace:
          type: boolean
        grant_active:
          type: boolean
        grant_required:
          type: boolean
        id:
          type: string
        instance_url:
          type: string
        platform:
          type: string
        supports_repost:
          type: boolean
        unavailable_reason:
          type: string
        username:
          type: string
        workspace_id:
          type: string
        workspace_name:
          type: string
      required:
      - id
      - workspace_id
      - workspace_name
      - platform
      - username
      - supports_repost
      - cross_workspace
      - grant_required
      - grant_active
      type: object
    Stage:
      additionalProperties: false
      properties:
        delay_seconds:
          description: Wait from the original publish time before this repost
          format: int64
          maximum: 2592000
          minimum: 0
          type: integer
        unrepost_previous:
          description: Remove the preceding repost before creating this one
          type: boolean
      required:
      - delay_seconds
      - unrepost_previous
      type: object
    PolicyInput:
      additionalProperties: false
      properties:
        enabled:
          type: boolean
        id:
          type: string
        name:
          type: string
        rule:
          $ref: '#/components/schemas/Rule'
        source_account_ids:
          description: Empty means every compatible source account in this workspace
          items:
            type: string
          type:
          - array
          - 'null'
        target_account_ids:
          items:
            type: string
          type:
          - array
          - 'null'
      required:
      - name
      - enabled
      - target_account_ids
      - rule
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    SettingsResponse:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/SettingsResponse.json
          format: uri
          readOnly: true
          type: string
        accounts:
          items:
            $ref: '#/components/schemas/AccountOption'
          type:
          - array
          - 'null'
        can_manage:
          type: boolean
        executions:
          items:
            $ref: '#/components/schemas/RepostExecutionResponse'
          type:
          - array
          - 'null'
        grants:
          items:
            $ref: '#/components/schemas/GrantResponse'
          type:
          - array
          - 'null'
        policies:
          items:
            $ref: '#/components/schemas/PolicyResponse'
          type:
          - array
          - 'null'
        revision:
          type: string
        supported_platforms:
          items:
            type: string
          type:
          - array
          - 'null'
        workspace_id:
          type: string
      required:
      - workspace_id
      - can_manage
      - supported_platforms
      - policies
      - accounts
      - grants
      type: object
    PolicyResponse:
      additionalProperties: false
      properties:
        created_at:
          type: string
        enabled:
          type: boolean
        id:
          type: string
        name:
          type: string
        rule:
          $ref: '#/components/schemas/Rule'
        source_account_ids:
          description: Empty means every compatible source account in this workspace
          items:
            type: string
          type:
          - array
          - 'null'
        target_account_ids:
          items:
            type: string
          type:
          - array
          - 'null'
        updated_at:
          type: string
      required:
      - name
      - enabled
      - target_account_ids
      - rule
      type: object
    GrantResponse:
      additionalProperties: false
      properties:
        created_at:
          type: string
        direction:
          enum:
          - outbound
          - inbound
          type: string
        id:
          type: string
        platform:
          type: string
        source_workspace_id:
          type: string
        source_workspace_name:
          type: string
        target_account_id:
          type: string
        target_username:
          type: string
        target_workspace_id:
          type: string
        target_workspace_name:
          type: string
      required:
      - id
      - source_workspace_id
      - source_workspace_name
      - target_workspace_id
      - target_workspace_name
      - target_account_id
      - target_username
      - platform
      - direction
      - created_at
      type: object
    Rule:
      additionalProperties: false
      properties:
        delay_seconds:
          description: Wait after publishing before the first eligibility check
          format: int64
          maximum: 2592000
          minimum: 0
          type: integer
        evaluation_window_seconds:
          description: How long OpenPost may wait for engagement gates
          format: int64
          maximum: 2592000
          minimum: 900
          type: integer
        min_comments:
          description: Minimum comments; zero disables this gate
          format: int64
          minimum: 0
          type: integer
        min_likes:
          description: Minimum likes; zero disables this gate
          format: int64
          minimum: 0
          type: integer
        min_reposts:
          description: Minimum reposts or shares; zero disables this gate
          format: int64
          minimum: 0
          type: integer
        min_views:
          description: Minimum views; zero disables this gate
          format: int64
          minimum: 0
          type: integer
        plateau_checks:
          description: Consecutive unchanged analytics checks required
          format: int64
          maximum: 12
          minimum: 2
          type: integer
        require_plateau:
          description: Wait until stored engagement has stopped changing
          type: boolean
        stages:
          description: Ordered repost times measured from the original publish time
          items:
            $ref: '#/components/schemas/Stage'
          maxItems: 20
          type:
          - array
          - 'null'
        threshold_mode:
          description: Require all configured thresholds or any one
          enum:
          - all
          - any
          type: string
      required:
      - delay_seconds
      - evaluation_window_seconds
      - threshold_mode
      - min_likes
      - min_comments
      - min_reposts
      - min_views
      - require_plateau
      - plateau_checks
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    RepostExecutionResponse:
      additionalProperties: false
      properties:
        created_at:
          format: date-time
          type: string
        current_stage:
          format: int64
          type: integer
        error:
          type: string
        history:
          items:
            $ref: '#/components/schemas/StageHistoryEntry'
          type:
          - array
          - 'null'
        id:
          type: string
        next_check_at:
          format: date-time
          type: string
        policy_id:
          type: string
        policy_name:
          type: string
        publication_id:
          type: string
        rule:
          $ref: '#/components/schemas/Rule'
        status:
          type: string
        target_account_id:
          type: string
        total_stages:
          format: int64
          type: integer
      required:
      - id
      - publication_id
      - target_account_id
      - status
      - current_stage
      - total_stages
      - rule
      - history
      - created_at
      type: object
    SaveRepostSettingsInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/SaveRepostSettingsInputBody.json
          format: uri
          readOnly: true
          type: string
        expected_revision:
          description: Revision returned by the last read; stale updates fail with 409
          type: string
        policies:
          description: Complete replacement set of workspace repost rules
          items:
            $ref: '#/components/schemas/PolicyInput'
          type:
          - array
          - 'null'
        workspace_id:
          description: Workspace ID
          type: string
      required:
      - workspace_id
      - policies
      type: object
    RepostGrantOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/RepostGrantOutputBody.json
          format: uri
          readOnly: true
          type: string
        message:
          type: string
      required:
      - message
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey