OpenPost Social Sets API

The Social Sets API from OpenPost — 3 operation(s) for social sets.

GitHub OpenAPI

Operations 6

GET /social-sets List Social Sets #
POST /social-sets Create a Social Set #
POST /social-sets/resolve-settings Resolve reusable settings for a Social Set account and format #
DELETE /social-sets/{id} Delete a Social Set #
GET /social-sets/{id} Get a Social Set #
PUT /social-sets/{id} Replace a Social Set #

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-social-sets-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-social-sets-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 Social Sets 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: Social Sets
paths:
  /social-sets:
    get:
      operationId: list-social-sets
      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:
                items:
                  $ref: '#/components/schemas/SocialSetResponse'
                type:
                - array
                - 'null'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: List Social Sets
      tags:
      - Social Sets
      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
    post:
      operationId: create-social-set
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSocialSetInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialSetResponse'
          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: Create a Social Set
      tags:
      - Social Sets
      x-openpost-automation:
        access: write
        effect: local-mutation
        exposure: disabled
        idempotency: none
        retry: never
  /social-sets/resolve-settings:
    post:
      operationId: resolve-social-set-settings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveSocialSetSettingsInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveSocialSetSettingsOutputBody'
          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
        '502':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Gateway
      summary: Resolve reusable settings for a Social Set account and format
      tags:
      - Social Sets
  /social-sets/{id}:
    delete:
      description: Existing publications keep their snapshotted destinations.
      operationId: delete-social-set
      parameters:
      - description: Social Set ID
        in: path
        name: id
        required: true
        schema:
          description: Social Set ID
          type: string
      - description: Explicit deletion confirmation
        explode: false
        in: query
        name: confirm
        schema:
          description: Explicit deletion confirmation
          type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionOutputBody'
          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
        '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: Delete a Social Set
      tags:
      - Social Sets
      x-openpost-automation:
        access: write
        effect: destructive
        exposure: disabled
        idempotency: none
        retry: never
    get:
      operationId: get-social-set
      parameters:
      - description: Social Set ID
        in: path
        name: id
        required: true
        schema:
          description: Social Set ID
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialSetResponse'
          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: Get a Social Set
      tags:
      - Social Sets
      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
        - label_path: name
          operation_id: list-social-sets
          parameter: id
          value_path: id
    put:
      operationId: update-social-set
      parameters:
      - description: Social Set ID
        in: path
        name: id
        required: true
        schema:
          description: Social Set ID
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSocialSetInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialSetResponse'
          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
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Replace a Social Set
      tags:
      - Social Sets
      x-openpost-automation:
        access: write
        effect: local-mutation
        exposure: disabled
        idempotency: none
        retry: never
components:
  schemas:
    CreateSocialSetInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/CreateSocialSetInputBody.json
          format: uri
          readOnly: true
          type: string
        accounts:
          description: Ordered connected accounts
          items:
            $ref: '#/components/schemas/SocialSetAccountInput'
          type:
          - array
          - 'null'
        is_default:
          description: Use this set when the composer opens
          type: boolean
        locale:
          description: BCP 47 locale for account settings validation
          type: string
        name:
          description: Social Set name
          maxLength: 80
          minLength: 1
          type: string
        region:
          description: ISO 3166-1 alpha-2 region for account settings validation
          type: string
        workspace_id:
          description: Target workspace ID
          type: string
      required:
      - workspace_id
      - name
      - accounts
      type: object
    ResolveSocialSetSettingsInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ResolveSocialSetSettingsInputBody.json
          format: uri
          readOnly: true
          type: string
        default_output_profile:
          description: Selected provider-qualified format
          type: string
        locale:
          description: BCP 47 locale for option labels
          type: string
        region:
          description: ISO 3166-1 alpha-2 region
          type: string
        settings:
          additionalProperties: {}
          description: Current destination and post preset values for account-specific options
          type: object
        social_account_id:
          description: Connected social account ID
          type: string
      required:
      - social_account_id
      - default_output_profile
      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
    ProviderDeliveryResponse:
      additionalProperties: false
      properties:
        current_attempt_created_at:
          type: string
        current_attempt_id:
          type: string
        current_attempt_number:
          format: int64
          type: integer
        error_code:
          description: Safe normalized provider failure code
          type: string
        error_http_status:
          format: int64
          type: integer
        error_kind:
          description: Safe normalized provider failure class
          type: string
        external_id:
          type: string
        external_url:
          type: string
        last_reconciled_at:
          type: string
        next_reconciliation_at:
          type: string
        recovery_action:
          enum:
          - none
          - retry
          - reconcile
          - manual_resolution
          type: string
        state:
          type: string
        target_key:
          type: string
        terminal_reason:
          type: string
      required:
      - target_key
      - state
      - current_attempt_id
      - current_attempt_number
      - current_attempt_created_at
      - recovery_action
      type: object
    UpdateSocialSetInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/UpdateSocialSetInputBody.json
          format: uri
          readOnly: true
          type: string
        accounts:
          description: Replacement ordered membership
          items:
            $ref: '#/components/schemas/SocialSetAccountInput'
          type:
          - array
          - 'null'
        is_default:
          description: Use this set when the composer opens
          type: boolean
        locale:
          description: BCP 47 locale for account settings validation
          type: string
        name:
          description: Social Set name
          maxLength: 80
          minLength: 1
          type: string
        region:
          description: ISO 3166-1 alpha-2 region for account settings validation
          type: string
      required:
      - name
      - is_default
      - accounts
      type: object
    ActionOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ActionOutputBody.json
          format: uri
          readOnly: true
          type: string
        activation_publication_id:
          type: string
        job_id:
          type: string
        message:
          type: string
        publication_id:
          type: string
        renditions:
          description: Exact destination outcomes after this action
          items:
            $ref: '#/components/schemas/RenditionActionOutcome'
          type:
          - array
          - 'null'
        revision:
          format: int64
          type: integer
        workspace_activated:
          type: boolean
      required:
      - message
      type: object
    SocialSetAccountInput:
      additionalProperties: false
      properties:
        default_output_profile:
          description: Optional provider-qualified default format
          type: string
        default_segment_settings:
          additionalProperties: {}
          description: Post settings copied into new rendition segments
          type: object
        default_settings:
          additionalProperties: {}
          description: Destination settings copied into new renditions
          type: object
        social_account_id:
          description: Connected social account ID
          type: string
      required:
      - social_account_id
      type: object
    SocialSetResponse:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/SocialSetResponse.json
          format: uri
          readOnly: true
          type: string
        accounts:
          items:
            $ref: '#/components/schemas/SocialSetAccountResponse'
          type:
          - array
          - 'null'
        created_at:
          type: string
        id:
          type: string
        is_default:
          type: boolean
        name:
          type: string
        updated_at:
          type: string
        workspace_id:
          type: string
      required:
      - id
      - workspace_id
      - name
      - is_default
      - accounts
      - created_at
      - updated_at
      type: object
    SettingCondition:
      additionalProperties: false
      properties:
        key:
          type: string
        operator:
          enum:
          - equals
          - not_equals
          - present
          - absent
          - in
          type: string
        value: {}
      required:
      - key
      - operator
      type: object
    SocialSetAccountResponse:
      additionalProperties: false
      properties:
        account_avatar_url:
          type: string
        account_username:
          type: string
        default_output_profile:
          type: string
        default_segment_settings:
          additionalProperties: {}
          type: object
        default_settings:
          additionalProperties: {}
          type: object
        display_order:
          format: int64
          type: integer
        platform:
          type: string
        social_account_id:
          type: string
      required:
      - social_account_id
      - platform
      - display_order
      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
    SettingConstraint:
      additionalProperties: false
      properties:
        accept:
          items:
            type: string
          type:
          - array
          - 'null'
        date_time:
          description: Value must be an RFC 3339 timestamp with a timezone
          type: boolean
        local_date_time:
          type: boolean
        max_items:
          format: int64
          type: integer
        max_length:
          format: int64
          type: integer
        maximum:
          format: double
          type: number
        min_items:
          format: int64
          type: integer
        min_length:
          format: int64
          type: integer
        minimum:
          format: double
          type: number
        pattern:
          type: string
        unique_items:
          type: boolean
      type: object
    SettingDefinition:
      additionalProperties: false
      properties:
        access_requirements:
          items:
            type: string
          type:
          - array
          - 'null'
        capability:
          type: string
        conflicts:
          items:
            $ref: '#/components/schemas/SettingCondition'
          type:
          - array
          - 'null'
        constraints:
          $ref: '#/components/schemas/SettingConstraint'
        control:
          type: string
        default: {}
        dependencies:
          items:
            $ref: '#/components/schemas/SettingCondition'
          type:
          - array
          - 'null'
        group:
          enum:
          - content
          - conversation
          - distribution
          - disclosure
          - media_accessibility
          type: string
        help:
          type: string
        intents:
          items:
            type: string
          type:
          - array
          - 'null'
        key:
          type: string
        label:
          type: string
        media_shapes:
          items:
            type: string
          type:
          - array
          - 'null'
        message_key:
          type: string
        options:
          items:
            type: string
          type:
          - array
          - 'null'
        options_source:
          type: string
        output_profiles:
          items:
            type: string
          type:
          - array
          - 'null'
        post_only:
          description: Choose this setting on each post, never in reusable Social Set defaults
          type: boolean
        required:
          type: boolean
        required_policy:
          enum:
          - never
          - always
          - when_available
          type: string
        scope:
          enum:
          - destination
          - segment
          - media_item
          type: string
        type:
          type: string
        unavailable_reason:
          type: string
      required:
      - key
      - message_key
      - label
      - group
      - control
      - type
      - scope
      - required
      type: object
    RenditionActionOutcome:
      additionalProperties: false
      properties:
        delivery:
          $ref: '#/components/schemas/ProviderDeliveryResponse'
        id:
          type: string
        platform:
          type: string
        social_account_id:
          type: string
        status:
          type: string
        target_key:
          type: string
      required:
      - id
      - social_account_id
      - target_key
      - platform
      - status
      type: object
    ResolveSocialSetSettingsOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ResolveSocialSetSettingsOutputBody.json
          format: uri
          readOnly: true
          type: string
        account_id:
          type: string
        output_profile:
          type: string
        settings:
          items:
            $ref: '#/components/schemas/SettingDefinition'
          type:
          - array
          - 'null'
      required:
      - account_id
      - output_profile
      - settings
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey