OpenPost Organizations API

The Organizations API from OpenPost — 3 operation(s) for organizations.

GitHub OpenAPI

Operations 3

DELETE /organizations/{id} Permanently delete an Organization and all of its Workspaces #
DELETE /organizations/{id}/billing-checkout-attempts/pending Cancel pending local Paddle checkout attempts #
GET /organizations/{id}/deletion-preview Preview permanent Organization deletion #

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-organizations-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-organizations-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 Organizations 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: Organizations
paths:
  /organizations/{id}:
    delete:
      description: Atomically deletes the complete Organization boundary after current-Owner authorization, exact canonical-name confirmation, recent authentication, and a final blocker check. Required content-free billing and audit evidence remains.
      operationId: delete-organization
      parameters:
      - description: Organization ID
        in: path
        name: id
        required: true
        schema:
          description: Organization ID
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrganizationDeletionInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationDeletionOutputBody'
          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
        '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
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Permanently delete an Organization and all of its Workspaces
      tags:
      - Organizations
  /organizations/{id}/billing-checkout-attempts/pending:
    delete:
      description: Cancels checkout attempts that have not produced a Paddle subscription so an Organization Owner can resolve a deletion blocker without waiting.
      operationId: cancel-organization-checkout-attempts
      parameters:
      - description: Organization ID
        in: path
        name: id
        required: true
        schema:
          description: Organization ID
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelOrganizationCheckoutAttemptsOutputBody'
          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: Cancel pending local Paddle checkout attempts
      tags:
      - Organizations
  /organizations/{id}/deletion-preview:
    get:
      description: Lists every owned Workspace, the local Paddle state, pending external work, access effects, retained evidence, irreversible loss, and every current blocker. Only the current Organization Owner can inspect it.
      operationId: get-organization-deletion-preview
      parameters:
      - description: Organization ID
        in: path
        name: id
        required: true
        schema:
          description: Organization ID
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationDeletionPreview'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unauthorized
        '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: Preview permanent Organization deletion
      tags:
      - Organizations
components:
  schemas:
    OrganizationDeletionInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/OrganizationDeletionInputBody.json
          format: uri
          readOnly: true
          type: string
        confirm_name:
          description: Exact canonical Organization name
          minLength: 1
          type: string
        current_password:
          description: Current account password
          type: string
        reauth_grant:
          description: One-time grant for organization.delete
          type: string
      required:
      - confirm_name
      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
    CancelOrganizationCheckoutAttemptsOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/CancelOrganizationCheckoutAttemptsOutputBody.json
          format: uri
          readOnly: true
          type: string
        canceled:
          format: int64
          type: integer
      required:
      - canceled
      type: object
    WorkspaceDeletionBlocker:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      required:
      - code
      - message
      type: object
    OrganizationDeletionPendingWork:
      additionalProperties: false
      properties:
        pending_cleanup_jobs:
          format: int64
          type: integer
        pending_jobs:
          format: int64
          type: integer
        pending_provider_writes:
          format: int64
          type: integer
      required:
      - pending_provider_writes
      - pending_jobs
      - pending_cleanup_jobs
      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
    OrganizationDeletionOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/OrganizationDeletionOutputBody.json
          format: uri
          readOnly: true
          type: string
        deleted:
          type: boolean
      required:
      - deleted
      type: object
    OrganizationDeletionWorkspace:
      additionalProperties: false
      properties:
        workspace_id:
          type: string
        workspace_name:
          type: string
      required:
      - workspace_id
      - workspace_name
      type: object
    OrganizationDeletionPreview:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/OrganizationDeletionPreview.json
          format: uri
          readOnly: true
          type: string
        access_effects:
          items:
            enum:
            - organization_memberships
            - workspace_memberships
            - organization_credentials
            type: string
          type:
          - array
          - 'null'
        billing_state:
          description: Latest local Paddle subscription state, or none
          type: string
        blockers:
          items:
            $ref: '#/components/schemas/WorkspaceDeletionBlocker'
          type:
          - array
          - 'null'
        irreversible_loss:
          items:
            enum:
            - workspaces
            - content
            - connected_accounts
            - media
            - settings
            type: string
          type:
          - array
          - 'null'
        organization_id:
          type: string
        organization_name:
          type: string
        pending_work:
          $ref: '#/components/schemas/OrganizationDeletionPendingWork'
        recovery_possible:
          type: boolean
        retained:
          items:
            enum:
            - required_audit_evidence
            - required_billing_evidence
            type: string
          type:
          - array
          - 'null'
        workspaces:
          items:
            $ref: '#/components/schemas/OrganizationDeletionWorkspace'
          type:
          - array
          - 'null'
      required:
      - organization_id
      - organization_name
      - workspaces
      - billing_state
      - pending_work
      - access_effects
      - retained
      - irreversible_loss
      - recovery_possible
      - blockers
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey