OpenPost · Schema

CreatePublicationBody

ContentSoftware-as-a-ServiceMarketingSocial MediaSolo Founders

Properties

Name Type Description
$schema string A URL to the JSON Schema for this object.
audience string Target audience
content_profile string Content profile
creation_preset string Starter preset; destination renditions own their formats
goal string Publication goal
intent string Deprecated compatibility alias for creation_preset
media arraynull Default ordered media
metadata object Publication metadata
random_delay_minutes integer Optional random schedule delay in minutes (±N); omit to inherit the Workspace setting when scheduled
renditions arraynull Explicit platform/account renditions
repost_override object Optional per-publication repost override
scheduled_at string Optional schedule time
segments arraynull Ordered canonical publication segments
social_account_ids arraynull Accounts to create default renditions for
social_set_id string Social Set used to initialize the snapshotted destinations
source_text string Canonical source text
source_url string Source URL for link shares
title string Internal publication title
workspace_id string Workspace ID
View JSON Schema on GitHub

JSON Schema

openpo-st-create-publication-body-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/openpo-st/json-schema/openpo-st-create-publication-body-schema.json",
  "title": "CreatePublicationBody",
  "x-generated": "2026-11-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openpo-st-openapi.json#/components/schemas/CreatePublicationBody",
  "additionalProperties": false,
  "properties": {
    "$schema": {
      "description": "A URL to the JSON Schema for this object.",
      "format": "uri",
      "readOnly": true,
      "type": "string"
    },
    "audience": {
      "description": "Target audience",
      "type": "string"
    },
    "content_profile": {
      "description": "Content profile",
      "type": "string"
    },
    "creation_preset": {
      "description": "Starter preset; destination renditions own their formats",
      "enum": [
        "post",
        "thread",
        "story",
        "short_video",
        "video"
      ],
      "type": "string"
    },
    "goal": {
      "description": "Publication goal",
      "type": "string"
    },
    "intent": {
      "description": "Deprecated compatibility alias for creation_preset",
      "enum": [
        "post",
        "thread",
        "story",
        "short_video",
        "video"
      ],
      "type": "string"
    },
    "media": {
      "description": "Default ordered media",
      "items": {
        "$ref": "#/$defs/PublicationMediaInput"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "metadata": {
      "additionalProperties": {},
      "description": "Publication metadata",
      "type": "object"
    },
    "random_delay_minutes": {
      "description": "Optional random schedule delay in minutes (±N); omit to inherit the Workspace setting when scheduled",
      "format": "int64",
      "maximum": 60,
      "minimum": 0,
      "type": "integer"
    },
    "renditions": {
      "description": "Explicit platform/account renditions",
      "items": {
        "$ref": "#/$defs/RenditionInput"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "repost_override": {
      "$ref": "#/$defs/Override",
      "description": "Optional per-publication repost override"
    },
    "scheduled_at": {
      "description": "Optional schedule time",
      "format": "date-time",
      "type": "string"
    },
    "segments": {
      "description": "Ordered canonical publication segments",
      "items": {
        "$ref": "#/$defs/PublicationSegmentInput"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "social_account_ids": {
      "description": "Accounts to create default renditions for",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "social_set_id": {
      "description": "Social Set used to initialize the snapshotted destinations",
      "type": "string"
    },
    "source_text": {
      "description": "Canonical source text",
      "type": "string"
    },
    "source_url": {
      "description": "Source URL for link shares",
      "type": "string"
    },
    "title": {
      "description": "Internal publication title",
      "type": "string"
    },
    "workspace_id": {
      "description": "Workspace ID",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "title",
    "content_profile",
    "source_text"
  ],
  "type": "object",
  "$defs": {
    "MentionProfile": {
      "additionalProperties": false,
      "properties": {
        "authority": {
          "maxLength": 2048,
          "type": "string"
        },
        "provider": {
          "maxLength": 40,
          "minLength": 1,
          "type": "string"
        },
        "target": {
          "$ref": "#/$defs/NativeMentionTarget",
          "description": "Validated native identity, or omitted for an ordinary text replacement"
        },
        "text": {
          "maxLength": 512,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "provider",
        "text"
      ],
      "type": "object"
    },
    "MentionSpan": {
      "additionalProperties": false,
      "properties": {
        "end": {
          "description": "Exclusive UTF-8 byte offset",
          "format": "int64",
          "minimum": 1,
          "type": "integer"
        },
        "start": {
          "description": "Inclusive UTF-8 byte offset in the exact authored text",
          "format": "int64",
          "minimum": 0,
          "type": "integer"
        },
        "target": {
          "$ref": "#/$defs/MentionTarget"
        },
        "text": {
          "description": "Exact visible text covered by the range",
          "maxLength": 512,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "start",
        "end",
        "text",
        "target"
      ],
      "type": "object"
    },
    "MentionTarget": {
      "additionalProperties": false,
      "properties": {
        "authority": {
          "description": "Connected instance origin for Mastodon; empty for global identity namespaces",
          "maxLength": 2048,
          "type": "string"
        },
        "handle": {
          "description": "Native account address returned by the provider lookup",
          "maxLength": 512,
          "type": "string"
        },
        "id": {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        "kind": {
          "enum": [
            "person",
            "page",
            "profile"
          ],
          "type": "string"
        },
        "profiles": {
          "description": "Immutable per-network snapshot for a reusable Workspace mention",
          "items": {
            "$ref": "#/$defs/MentionProfile"
          },
          "maxItems": 32,
          "type": [
            "array",
            "null"
          ]
        },
        "provider": {
          "enum": [
            "bluesky",
            "mastodon",
            "linkedin",
            "workspace"
          ],
          "type": "string"
        }
      },
      "required": [
        "provider",
        "kind",
        "id"
      ],
      "type": "object"
    },
    "Mentions": {
      "additionalProperties": false,
      "properties": {
        "spans": {
          "description": "Ordered, nonoverlapping native mention selections; an empty list explicitly contains no selected mentions",
          "items": {
            "$ref": "#/$defs/MentionSpan"
          },
          "maxItems": 50,
          "type": "array"
        },
        "version": {
          "enum": [
            1
          ],
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "version",
        "spans"
      ],
      "type": "object"
    },
    "NativeMentionTarget": {
      "additionalProperties": false,
      "properties": {
        "authority": {
          "maxLength": 2048,
          "type": "string"
        },
        "handle": {
          "maxLength": 512,
          "type": "string"
        },
        "id": {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        "kind": {
          "enum": [
            "person",
            "page"
          ],
          "type": "string"
        },
        "provider": {
          "enum": [
            "bluesky",
            "mastodon",
            "linkedin"
          ],
          "type": "string"
        }
      },
      "required": [
        "provider",
        "kind",
        "id"
      ],
      "type": "object"
    },
    "Override": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "description": "Use workspace rules, disable reposts, or use this post's custom rule",
          "enum": [
            "inherit",
            "off",
            "custom"
          ],
          "type": "string"
        },
        "rule": {
          "$ref": "#/$defs/Rule",
          "description": "Custom timing and engagement gates"
        },
        "target_account_ids": {
          "description": "Target accounts for a custom override",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "mode"
      ],
      "type": "object"
    },
    "PublicationMediaInput": {
      "additionalProperties": false,
      "properties": {
        "alt_text": {
          "description": "Alt text override",
          "type": "string"
        },
        "media_id": {
          "description": "Media attachment ID",
          "type": "string"
        },
        "role": {
          "description": "Media role: attachment, cover, thumbnail",
          "type": "string"
        },
        "settings": {
          "additionalProperties": {},
          "description": "Media-item settings",
          "type": "object"
        },
        "thumbnail_timestamp_ms": {
          "description": "Video thumbnail timestamp",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "media_id"
      ],
      "type": "object"
    },
    "PublicationSegmentInput": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "Canonical segment body",
          "type": "string"
        },
        "description": {
          "description": "Canonical segment description",
          "type": "string"
        },
        "id": {
          "description": "Client segment reference on create, or an existing server segment ID on update",
          "type": "string"
        },
        "media": {
          "description": "Ordered canonical segment media",
          "items": {
            "$ref": "#/$defs/PublicationMediaInput"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "settings": {
          "additionalProperties": {},
          "description": "Canonical segment settings",
          "properties": {
            "mentions": {
              "$ref": "#/$defs/Mentions"
            }
          },
          "type": "object"
        },
        "title": {
          "description": "Canonical segment title",
          "type": "string"
        },
        "url": {
          "description": "Canonical segment URL",
          "type": "string"
        }
      },
      "type": "object"
    },
    "RenditionInput": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "Platform-specific body",
          "type": "string"
        },
        "description": {
          "description": "Platform-specific description",
          "type": "string"
        },
        "format_locked": {
          "description": "Preserve an explicitly selected format when source content changes",
          "type": "boolean"
        },
        "id": {
          "description": "Legacy client reference; replacement IDs are server-generated",
          "type": "string"
        },
        "media": {
          "description": "Rendition-specific ordered media",
          "items": {
            "$ref": "#/$defs/PublicationMediaInput"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "output_profile": {
          "description": "Resolved provider-qualified output profile",
          "type": "string"
        },
        "profile": {
          "description": "Content profile override",
          "type": "string"
        },
        "schedule_override": {
          "description": "Optional destination-specific schedule",
          "format": "date-time",
          "type": "string"
        },
        "segments": {
          "description": "Ordered destination segments",
          "items": {
            "$ref": "#/$defs/RenditionSegmentInput"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "settings": {
          "additionalProperties": {},
          "description": "Provider-specific settings",
          "type": "object"
        },
        "social_account_id": {
          "description": "Social account ID",
          "type": "string"
        },
        "target_key": {
          "description": "Provider subdestination key; defaults to the account destination",
          "type": "string"
        },
        "title": {
          "description": "Platform-specific title",
          "type": "string"
        }
      },
      "required": [
        "social_account_id"
      ],
      "type": "object"
    },
    "RenditionSegmentInput": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "Destination segment body override",
          "type": "string"
        },
        "body_override": {
          "description": "Explicit destination body; omit or null to inherit",
          "type": "string"
        },
        "description": {
          "description": "Destination segment description override",
          "type": "string"
        },
        "description_override": {
          "description": "Explicit destination description; omit or null to inherit",
          "type": "string"
        },
        "id": {
          "description": "Legacy client reference; replacement IDs are server-generated",
          "type": "string"
        },
        "media": {
          "description": "Destination segment ordered media",
          "items": {
            "$ref": "#/$defs/PublicationMediaInput"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "media_inherited": {
          "description": "Whether destination media follows the canonical segment",
          "type": "boolean"
        },
        "publication_segment_id": {
          "description": "Server canonical segment ID, or its matching client segment reference in the same request",
          "type": "string"
        },
        "settings": {
          "additionalProperties": {},
          "description": "Segment-scoped destination settings",
          "properties": {
            "mentions": {
              "$ref": "#/$defs/Mentions"
            }
          },
          "type": "object"
        },
        "source_overrides": {
          "description": "Authored canonical-source overrides for a single joined destination output",
          "items": {
            "$ref": "#/$defs/RenditionSourceOverride"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "title": {
          "description": "Destination segment title override",
          "type": "string"
        },
        "title_override": {
          "description": "Explicit destination title; omit or null to inherit",
          "type": "string"
        },
        "url": {
          "description": "Destination segment URL override",
          "type": "string"
        },
        "url_override": {
          "description": "Explicit destination URL; omit or null to inherit",
          "type": "string"
        }
      },
      "type": "object"
    },
    "RenditionSourceOverride": {
      "additionalProperties": false,
      "properties": {
        "body_override": {
          "description": "Explicit source body; omit or null to inherit",
          "type": "string"
        },
        "media": {
          "description": "Independent source media, including an explicit empty list",
          "items": {
            "$ref": "#/$defs/PublicationMediaInput"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "media_inherited": {
          "description": "Whether this source contributes its canonical media",
          "type": "boolean"
        },
        "mentions": {
          "$ref": "#/$defs/Mentions",
          "description": "Mention selections paired with this explicit source body; omit to inherit"
        },
        "publication_segment_id": {
          "description": "Canonical source segment ID, or matching client reference in the same request",
          "type": "string"
        }
      },
      "required": [
        "publication_segment_id",
        "media_inherited"
      ],
      "type": "object"
    },
    "Rule": {
      "additionalProperties": false,
      "properties": {
        "delay_seconds": {
          "description": "Wait after publishing before the first eligibility check",
          "format": "int64",
          "maximum": 2592000,
          "minimum": 0,
          "type": "integer"
        },
        "evaluation_window_seconds": {
          "description": "How long OpenPost may wait for engagement gates",
          "format": "int64",
          "maximum": 2592000,
          "minimum": 900,
          "type": "integer"
        },
        "min_comments": {
          "description": "Minimum comments; zero disables this gate",
          "format": "int64",
          "minimum": 0,
          "type": "integer"
        },
        "min_likes": {
          "description": "Minimum likes; zero disables this gate",
          "format": "int64",
          "minimum": 0,
          "type": "integer"
        },
        "min_reposts": {
          "description": "Minimum reposts or shares; zero disables this gate",
          "format": "int64",
          "minimum": 0,
          "type": "integer"
        },
        "min_views": {
          "description": "Minimum views; zero disables this gate",
          "format": "int64",
          "minimum": 0,
          "type": "integer"
        },
        "plateau_checks": {
          "description": "Consecutive unchanged analytics checks required",
          "format": "int64",
          "maximum": 12,
          "minimum": 2,
          "type": "integer"
        },
        "require_plateau": {
          "description": "Wait until stored engagement has stopped changing",
          "type": "boolean"
        },
        "stages": {
          "description": "Ordered repost times measured from the original publish time",
          "items": {
            "$ref": "#/$defs/Stage"
          },
          "maxItems": 20,
          "type": [
            "array",
            "null"
          ]
        },
        "threshold_mode": {
          "description": "Require all configured thresholds or any one",
          "enum": [
            "all",
            "any"
          ],
          "type": "string"
        }
      },
      "required": [
        "delay_seconds",
        "evaluation_window_seconds",
        "threshold_mode",
        "min_likes",
        "min_comments",
        "min_reposts",
        "min_views",
        "require_plateau",
        "plateau_checks"
      ],
      "type": "object"
    },
    "Stage": {
      "additionalProperties": false,
      "properties": {
        "delay_seconds": {
          "description": "Wait from the original publish time before this repost",
          "format": "int64",
          "maximum": 2592000,
          "minimum": 0,
          "type": "integer"
        },
        "unrepost_previous": {
          "description": "Remove the preceding repost before creating this one",
          "type": "boolean"
        }
      },
      "required": [
        "delay_seconds",
        "unrepost_previous"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/openpo-st-create-publication-body"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.