OpenPost Provider Readiness API
The Provider Readiness API from OpenPost — 4 operation(s) for provider readiness.
The Provider Readiness API from OpenPost — 4 operation(s) for provider readiness.
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-provider-readiness-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 Provider Readiness 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: Provider Readiness
paths:
/admin/provider-readiness/approval-reviews:
post:
operationId: append-provider-approval-review
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AppendProviderApprovalReviewInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ProviderReadinessLedgerAppendOutputBody'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unauthorized
'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
security:
- sessionCookie: []
summary: Append a provider approval review
tags:
- Provider Readiness
/admin/provider-readiness/certifications:
post:
operationId: append-provider-certification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AppendProviderCertificationInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ProviderReadinessLedgerAppendOutputBody'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unauthorized
'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
security:
- sessionCookie: []
summary: Append normalized provider certification evidence
tags:
- Provider Readiness
/admin/provider-readiness/runtime-controls:
post:
operationId: append-provider-runtime-control
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AppendProviderRuntimeControlInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ProviderReadinessLedgerAppendOutputBody'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unauthorized
'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
security:
- sessionCookie: []
summary: Append a provider runtime control
tags:
- Provider Readiness
/provider-readiness:
get:
operationId: get-provider-readiness
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/ProviderReadinessOutputBody'
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
'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: Inspect provider readiness for a workspace
tags:
- Provider Readiness
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
components:
schemas:
ProviderReadinessProfile:
additionalProperties: false
properties:
immediate:
$ref: '#/components/schemas/Decision'
output_profile:
type: string
scheduled:
$ref: '#/components/schemas/Decision'
social_account_id:
type: string
required:
- social_account_id
- output_profile
- immediate
- scheduled
type: object
ProviderReadinessOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/ProviderReadinessOutputBody.json
format: uri
readOnly: true
type: string
providers:
items:
$ref: '#/components/schemas/ProviderReadinessItem'
type:
- array
- 'null'
required:
- providers
type: object
RuntimeControlSelector:
additionalProperties: false
properties:
account_kind:
type: string
app_fingerprint:
type: string
deployment_environment:
type: string
instance_fingerprint:
type: string
operation:
type: string
output_profile:
type: string
policy_mode:
type: string
provider:
type: string
provider_environment:
type: string
required:
- provider
type: object
AppendProviderApprovalReviewInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/AppendProviderApprovalReviewInputBody.json
format: uri
readOnly: true
type: string
app_fingerprint:
type: string
expires_at:
format: date-time
type: string
instance_fingerprint:
type: string
provider:
type: string
provider_environment:
enum:
- development
- sandbox
- production
type: string
reviewed_at:
format: date-time
type: string
source_url:
format: uri
type: string
state:
enum:
- unknown
- not_required
- pending
- trial
- approved
- restricted
- revoked
type: string
tier:
type: string
required:
- provider
- app_fingerprint
- provider_environment
- state
- tier
- source_url
- reviewed_at
- expires_at
type: object
ProviderReadinessAccount:
additionalProperties: false
properties:
analytics:
$ref: '#/components/schemas/Decision'
social_account_id:
type: string
required:
- social_account_id
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
CheckResult:
additionalProperties: false
properties:
completed_at:
format: date-time
type: string
error_class:
type: string
external_ref_hash:
type: string
kind:
type: string
not_applicable_reason:
type: string
outcome:
type: string
required:
- kind
- outcome
- completed_at
type: object
Facts:
additionalProperties: false
properties:
approval:
type: string
authorization:
type: string
configuration:
type: string
control:
type: string
live_certification:
type: string
local_test:
type: string
policy:
type: string
required:
- configuration
- local_test
- live_certification
- approval
- authorization
- control
- policy
type: object
ProviderReadinessLedgerAppendOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/ProviderReadinessLedgerAppendOutputBody.json
format: uri
readOnly: true
type: string
id:
type: string
required:
- id
type: object
Decision:
additionalProperties: false
properties:
advertisable:
type: boolean
analytics_ready:
type: boolean
blockers:
items:
$ref: '#/components/schemas/Blocker'
type:
- array
- 'null'
connectable:
type: boolean
contract_digest:
type: string
discoverable:
type: boolean
executable:
type: boolean
facts:
$ref: '#/components/schemas/Facts'
observable:
type: boolean
publishable:
type: boolean
state:
type: string
required:
- state
- executable
- connectable
- publishable
- discoverable
- observable
- analytics_ready
- advertisable
- facts
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
Blocker:
additionalProperties: false
properties:
code:
type: string
detail:
type: string
required:
- code
type: object
ProviderReadinessItem:
additionalProperties: false
properties:
accounts:
items:
$ref: '#/components/schemas/ProviderReadinessAccount'
type:
- array
- 'null'
advertisable:
type: boolean
blocking_issues:
items:
type: string
type:
- array
- 'null'
configured_app_state:
type: string
connectable:
type: boolean
connected_accounts:
format: int64
type: integer
facts:
$ref: '#/components/schemas/Facts'
profiles:
items:
$ref: '#/components/schemas/ProviderReadinessProfile'
type:
- array
- 'null'
provider:
type: string
state:
type: string
required:
- provider
- state
- connectable
- advertisable
- facts
- configured_app_state
- connected_accounts
type: object
AppendProviderRuntimeControlInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/AppendProviderRuntimeControlInputBody.json
format: uri
readOnly: true
type: string
expires_at:
format: date-time
type: string
reason_code:
type: string
selector:
$ref: '#/components/schemas/RuntimeControlSelector'
starts_at:
format: date-time
type: string
state:
enum:
- enabled
- degraded
- disabled
type: string
required:
- selector
- state
- reason_code
- starts_at
type: object
AppendProviderCertificationInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/AppendProviderCertificationInputBody.json
format: uri
readOnly: true
type: string
approval_review_id:
type: string
checks:
items:
$ref: '#/components/schemas/CheckResult'
minItems: 1
type:
- array
- 'null'
expires_at:
format: date-time
type: string
kind:
enum:
- local
- live
type: string
operation:
enum:
- discover
- analytics
- publish_immediate
- publish_scheduled
type: string
output_profile:
description: Required for publishing certification; omitted for account discovery and analytics
type: string
policy_mode:
description: Optional asserted normalized policy mode; the server derives and verifies it
type: string
policy_settings:
additionalProperties: {}
type: object
social_account_id:
type: string
tested_at:
format: date-time
type: string
workspace_id:
type: string
required:
- approval_review_id
- workspace_id
- social_account_id
- operation
- kind
- tested_at
- expires_at
- checks
type: object
securitySchemes:
bearerAuth:
bearerFormat: OpenPost API token or session JWT
scheme: bearer
type: http
sessionCookie:
in: cookie
name: openpost_session
type: apiKey