Publication Builds

Build destination-native posts

post/publication-builds

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/publication-builds
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Headers

Idempotency-Keystring required

Stable key for one logical build request

Request body

$schemastring uri

A URL to the JSON Schema for this object.

account_idsstring[] nullable

Candidate connected account IDs

context_may_publishboolean

Allow text from context notes to appear in generated drafts

context_notesstring

Private planning notes supplied as untrusted source material

context_urlsstring[] nullable

Public HTTP or HTTPS sources loaded by the guarded background worker

destination_policy'recommend' | 'require_all'

Allow the director to skip weak destinations or require every candidate

ideastring

Idea, note, update, or Markdown source text

option_count0 | 4

Four complete creative alternatives, or the existing single package

series_countinteger

Plan up to three complementary posts before generating selected drafts

social_set_idstring

Optional Social Set candidate snapshot

voice_profile_idstring

Optional build-level Voice Profile override

workspace_idstring required

Workspace that owns the source material and destinations

Example request

{
  "$schema": "https://example.com/api/v1/schemas/CreatePublicationBuildBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

context_urlsstring[] nullable
created_atstring date-time required
error_codestring
error_messagestring
idstring required
phasestring required
publication_idstring
revisioninteger required
social_set_idstring
statestring required
updated_atstring date-time required
voice_profile_idstring
workspace_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.