OpenPost Posting Schedules API
The Posting Schedules API from OpenPost — 5 operation(s) for posting schedules.
The Posting Schedules API from OpenPost — 5 operation(s) for posting schedules.
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-posting-schedules-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 Posting Schedules 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: Posting Schedules
paths:
/posting-schedules:
get:
operationId: list-posting-schedules
parameters:
- description: Filter by workspace ID
explode: false
in: query
name: workspace_id
schema:
description: Filter by workspace ID
type: string
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/PostingScheduleResponse'
type:
- array
- 'null'
description: OK
'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: List posting schedules for a workspace
tags:
- Posting Schedules
x-openpost-automation:
access: read
effect: query
exposure: disabled
idempotency: none
retry: transient
post:
operationId: create-posting-schedule
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePostingScheduleInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PostingScheduleResponse'
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: Create a new posting schedule slot
tags:
- Posting Schedules
x-openpost-automation:
access: write
effect: local-mutation
exposure: disabled
idempotency: none
retry: never
/posting-schedules/batch-delete:
post:
operationId: batch-delete-posting-schedules
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchDeletePostingSchedulesInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DeletePostingScheduleOutputBody'
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: Atomically delete a weekly posting time row
tags:
- Posting Schedules
/posting-schedules/next-slot:
get:
operationId: get-next-available-slot
parameters:
- description: Workspace ID
explode: false
in: query
name: workspace_id
schema:
description: Workspace ID
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/NextAvailableSlotOutputBody'
description: OK
'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: Get the next available posting time slot
tags:
- Posting Schedules
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
/posting-schedules/suggest:
post:
operationId: suggest-posting-schedule
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SuggestScheduleInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SuggestScheduleOutputBody'
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: Generate a suggested posting schedule
tags:
- Posting Schedules
/posting-schedules/{id}:
delete:
operationId: delete-posting-schedule
parameters:
- description: Schedule ID
in: path
name: id
required: true
schema:
description: Schedule ID
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DeletePostingScheduleOutputBody'
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: Delete a posting schedule slot
tags:
- Posting Schedules
x-openpost-automation:
access: write
effect: destructive
exposure: disabled
idempotency: none
retry: never
patch:
operationId: update-posting-schedule
parameters:
- description: Schedule ID
in: path
name: id
required: true
schema:
description: Schedule ID
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePostingScheduleInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PostingScheduleResponse'
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: Update a posting schedule slot
tags:
- Posting Schedules
x-openpost-automation:
access: write
effect: local-mutation
exposure: disabled
idempotency: none
retry: never
components:
schemas:
BatchDeletePostingSchedulesInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/BatchDeletePostingSchedulesInputBody.json
format: uri
readOnly: true
type: string
ids:
description: Schedule slot IDs from one weekly time row. Missing IDs are ignored for safe retries.
items:
type: string
maxItems: 7
minItems: 1
type:
- array
- 'null'
workspace_id:
description: Workspace owning the schedule slots
minLength: 1
type: string
required:
- workspace_id
- ids
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
SuggestScheduleOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/SuggestScheduleOutputBody.json
format: uri
readOnly: true
type: string
message:
description: Message about the result
type: string
schedules:
description: Created schedule slots
items:
$ref: '#/components/schemas/PostingScheduleResponse'
type:
- array
- 'null'
required:
- schedules
- message
type: object
NextAvailableSlotOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/NextAvailableSlotOutputBody.json
format: uri
readOnly: true
type: string
message:
description: Message about the result
type: string
slot:
$ref: '#/components/schemas/PostingScheduleResponse'
description: Next available schedule slot
slot_time:
description: The suggested time in ISO 8601 format
type: string
required:
- slot_time
- message
type: object
UpdatePostingScheduleInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/UpdatePostingScheduleInputBody.json
format: uri
readOnly: true
type: string
day_of_week:
description: Workspace-local day of week (0=Sunday, 6=Saturday)
format: int64
type: integer
is_active:
description: Whether this slot is active
type: boolean
label:
description: Display label
type: string
utc_hour:
description: Legacy field name for the workspace-local hour (0-23)
format: int64
type: integer
utc_minute:
description: Legacy field name for the workspace-local minute (0-59)
format: int64
type: integer
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
SuggestScheduleInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/SuggestScheduleInputBody.json
format: uri
readOnly: true
type: string
posts_per_day:
description: Number of posts per day (1-10)
format: int64
type: integer
workspace_id:
description: Workspace ID
type: string
required:
- workspace_id
- posts_per_day
type: object
DeletePostingScheduleOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/DeletePostingScheduleOutputBody.json
format: uri
readOnly: true
type: string
message:
description: Success message
type: string
required:
- message
type: object
CreatePostingScheduleInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/CreatePostingScheduleInputBody.json
format: uri
readOnly: true
type: string
day_of_week:
description: Workspace-local day of week (0=Sunday, 6=Saturday)
format: int64
type: integer
label:
description: Display label
type: string
local_day_of_week:
description: Day of week in workspace local time (0=Sunday, 6=Saturday)
format: int64
type: integer
local_hour:
description: Hour in workspace local time (0-23)
format: int64
type: integer
local_minute:
description: Minute in workspace local time (0-59)
format: int64
type: integer
utc_hour:
description: Legacy field name for the workspace-local hour (0-23)
format: int64
type: integer
utc_minute:
description: Legacy field name for the workspace-local minute (0-59)
format: int64
type: integer
workspace_id:
description: Workspace ID
type: string
required:
- workspace_id
- utc_hour
- utc_minute
- day_of_week
type: object
PostingScheduleResponse:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/PostingScheduleResponse.json
format: uri
readOnly: true
type: string
created_at:
description: Creation time (ISO 8601)
type: string
day_of_week:
description: Workspace-local day of week (0=Sunday, 6=Saturday)
format: int64
type: integer
id:
description: Schedule ID
type: string
is_active:
description: Whether this slot is active
type: boolean
label:
description: Display label (e.g., Morning, Lunch)
type: string
local_day_of_week:
description: Day of week in workspace local time (0=Sunday, 6=Saturday)
format: int64
type: integer
local_hour:
description: Hour in workspace local time (0-23)
format: int64
type: integer
local_minute:
description: Minute in workspace local time (0-59)
format: int64
type: integer
utc_hour:
description: Legacy field name for the workspace-local hour (0-23)
format: int64
type: integer
utc_minute:
description: Legacy field name for the workspace-local minute (0-59)
format: int64
type: integer
workspace_id:
description: Workspace ID
type: string
required:
- id
- workspace_id
- utc_hour
- utc_minute
- day_of_week
- local_hour
- local_minute
- local_day_of_week
- is_active
- created_at
type: object
securitySchemes:
bearerAuth:
bearerFormat: OpenPost API token or session JWT
scheme: bearer
type: http
sessionCookie:
in: cookie
name: openpost_session
type: apiKey