SEsenso
Content Engine

Publish generated content

Publishes generated markdown as a content item to the org's destinations. Returns 201 when the content is created/published, or 200 when the content is created but publishing to the destinations failed (inspect publish_status and publish_destinations). Requires the GEO product.

post/org/content-engine/publish

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Request body

geo_question_idstring uuid

The prompt this content answers.

content_idstring uuid

The existing content item to publish a new version of, if updating.

generation_run_idstring uuid

The generation run this publish belongs to, if any.

generation_receipt_idstring uuid
ever_publishedboolean

Legacy compatibility field; ignored by the server.

raw_markdownstring required
seo_titlestring required
summarystring
publisher_idsstring[]

The destinations to publish to. Omit to use the org's configured destinations.

mark_as_publishedboolean

Record the content as already published externally rather than publishing it now.

manual_published_atstring date-time

When it was published externally (mark_as_published only).

manual_published_urlstring

Where it went live (mark_as_published only); used for citation attribution.

builder_workspace_idstring uuid
expected_workspace_version_idstring uuid

Response

Content created, but publishing to one or more destinations failed.

content_idstring uuid required
version_idstring uuid required
version_numinteger required
citeables_actionstring required

Legacy informational field.

publish_statusstring required

Overall publish status: success or failed.

editorial_statusstring required

The content's editorial state after publishing (e.g. published, draft).

publish_destinationstring required

Legacy single-destination label.

marked_as_publishedboolean

Whether the content was recorded as manually published.

source_workspace_version_idstring uuid

Changes

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