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 |
JSON Schema
{
"$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.
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.