OpenPost Repurpose API
The Repurpose API from OpenPost — 4 operation(s) for repurpose.
The Repurpose API from OpenPost — 4 operation(s) for repurpose.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-repurpose-api"
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.
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: 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