OpenPost Repost Automation API
The Repost Automation API from OpenPost — 2 operation(s) for repost automation.
The Repost Automation API from OpenPost — 2 operation(s) for repost automation.
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-repost-automation-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 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