OpenPost Repurpose API

The Repurpose API from OpenPost — 4 operation(s) for repurpose.

GitHub OpenAPI

Operations 4

POST /repurpose-suggestions Suggest up to three source-grounded clips for review #
GET /repurpose-suggestions/{id} Read clip suggestion progress and candidates #
POST /repurpose-suggestions/{id}/cancel Cancel the current clip suggestion revision #
POST /repurpose-suggestions/{id}/retry Retry a failed or cancelled clip suggestion revision #

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-repurpose-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-repurpose-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 Repurpose 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: Repurpose
paths:
  /repurpose-suggestions:
    post:
      operationId: create-repurpose-suggestions
      parameters:
      - in: header
        name: Idempotency-Key
        required: true
        schema:
          maxLength: 160
          minLength: 8
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SuggestionRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClipSuggestions'
          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
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '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
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Suggest up to three source-grounded clips for review
      tags:
      - Repurpose
  /repurpose-suggestions/{id}:
    get:
      operationId: get-repurpose-suggestions
      parameters:
      - in: path
        name: id
        required: true
        schema:
          maxLength: 200
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClipSuggestions'
          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
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '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
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Read clip suggestion progress and candidates
      tags:
      - Repurpose
  /repurpose-suggestions/{id}/cancel:
    post:
      operationId: cancel-repurpose-suggestions
      parameters:
      - in: path
        name: id
        required: true
        schema:
          maxLength: 200
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepurposeSuggestionsRevisionInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClipSuggestions'
          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
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '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
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Cancel the current clip suggestion revision
      tags:
      - Repurpose
  /repurpose-suggestions/{id}/retry:
    post:
      operationId: retry-repurpose-suggestions
      parameters:
      - in: path
        name: id
        required: true
        schema:
          maxLength: 200
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepurposeSuggestionsRevisionInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClipSuggestions'
          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
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '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
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Retry a failed or cancelled clip suggestion revision
      tags:
      - Repurpose
components:
  schemas:
    TranscriptSource:
      additionalProperties: false
      properties:
        audio_track_index:
          format: int64
          maximum: 1000
          minimum: 0
          type: integer
        duration:
          exclusiveMinimum: 0
          format: double
          maximum: 7200
          type: number
        id:
          maxLength: 200
          minLength: 1
          type: string
        media_id:
          description: Set for workspace Media sources. Access and availability are rechecked before analysis.
          maxLength: 200
          type: string
        revision:
          description: Caller snapshot fingerprint, not a server-verified media revision. Compare with the current source before applying.
          maxLength: 200
          minLength: 1
          type: string
        words:
          items:
            $ref: '#/components/schemas/TranscriptWord'
          maxItems: 12000
          minItems: 1
          type:
          - array
          - 'null'
      required:
      - id
      - revision
      - audio_track_index
      - duration
      - words
      type: object
    RepurposeSuggestionsRevisionInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/RepurposeSuggestionsRevisionInputBody.json
          format: uri
          readOnly: true
          type: string
        revision:
          format: int64
          minimum: 1
          type: integer
      required:
      - revision
      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
    ClipCandidate:
      additionalProperties: false
      properties:
        context_warning:
          type: string
        end:
          description: Exact end of last_word in source seconds, never generated by AI.
          format: double
          type: number
        first_word:
          description: Inclusive zero-based index in the submitted source words.
          format: int64
          type: integer
        id:
          type: string
        last_word:
          description: Inclusive zero-based index in the submitted source words.
          format: int64
          type: integer
        rationale:
          type: string
        start:
          description: Exact start of first_word in source seconds, never generated by AI.
          format: double
          type: number
        title:
          type: string
      required:
      - id
      - first_word
      - last_word
      - start
      - end
      - title
      - rationale
      - context_warning
      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
    TranscriptWord:
      additionalProperties: false
      properties:
        end:
          format: double
          maximum: 7200
          minimum: 0
          type: number
        start:
          format: double
          maximum: 7200
          minimum: 0
          type: number
        text:
          maxLength: 200
          minLength: 1
          type: string
      required:
      - text
      - start
      - end
      type: object
    SuggestionRequest:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/SuggestionRequest.json
          format: uri
          readOnly: true
          type: string
        audience:
          maxLength: 1000
          type: string
        desired_duration_seconds:
          description: Preferred clip duration, not a forced length. Defaults to 45 seconds; shorter complete thoughts are allowed.
          format: int64
          maximum: 180
          minimum: 10
          type: integer
        source:
          $ref: '#/components/schemas/TranscriptSource'
        topic:
          maxLength: 1000
          type: string
        workspace_id:
          maxLength: 200
          minLength: 1
          type: string
      required:
      - workspace_id
      - source
      type: object
    ClipSuggestions:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ClipSuggestions.json
          format: uri
          readOnly: true
          type: string
        candidates:
          items:
            $ref: '#/components/schemas/ClipCandidate'
          maxItems: 3
          type:
          - array
          - 'null'
        error_message:
          type: string
        id:
          type: string
        revision:
          format: int64
          type: integer
        source_id:
          type: string
        source_revision:
          description: The caller snapshot fingerprint captured at submission.
          type: string
        state:
          enum:
          - queued
          - analyzing
          - ready
          - failed
          - cancelled
          type: string
        updated_at:
          format: date-time
          type: string
        workspace_id:
          type: string
      required:
      - id
      - workspace_id
      - source_id
      - source_revision
      - revision
      - state
      - candidates
      - updated_at
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey