OpenPost Social Sets API
The Social Sets API from OpenPost — 3 operation(s) for social sets.
The Social Sets API from OpenPost — 3 operation(s) for social sets.
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-social-sets-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 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