OpenPost Posting Schedules API

The Posting Schedules API from OpenPost — 5 operation(s) for posting schedules.

GitHub OpenAPI

Operations 7

GET /posting-schedules List posting schedules for a workspace #
POST /posting-schedules Create a new posting schedule slot #
POST /posting-schedules/batch-delete Atomically delete a weekly posting time row #
GET /posting-schedules/next-slot Get the next available posting time slot #
POST /posting-schedules/suggest Generate a suggested posting schedule #
DELETE /posting-schedules/{id} Delete a posting schedule slot #
PATCH /posting-schedules/{id} Update a posting schedule slot #

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-posting-schedules-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-posting-schedules-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 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