OpenPost Provider Readiness API

The Provider Readiness API from OpenPost — 4 operation(s) for provider readiness.

GitHub OpenAPI

Operations 4

POST /admin/provider-readiness/approval-reviews Append a provider approval review #
POST /admin/provider-readiness/certifications Append normalized provider certification evidence #
POST /admin/provider-readiness/runtime-controls Append a provider runtime control #
GET /provider-readiness Inspect provider readiness for a workspace #

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-provider-readiness-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-provider-readiness-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 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