Skip to main content
POST
Mark a content as published

Authorizations

Authorization
string
header
required

API key starting with sk_. Generate one in Settings > API Keys.

Path Parameters

contentId
string
required

Content ID.

Body

application/json
publishedAt
string<date-time>

Publication date (ISO 8601). Defaults to the current server time.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
url
string<uri>

Target publication URL. Defaults to the associated page URL.

Response

200 - application/json

Default Response

assignedTo
object | null
required

User assigned to this content.

contentScore
integer | null
required

This score out of 100 measures the SEO quality of a content.

contentStatus
object | null
required

Workflow status assigned to this content.

contentUpdatedAt
string | null
required

ISO 8601 date of the last content body change.

createdAt
string
required

ISO 8601 creation date.

dueDate
string | null
required

Due date (ISO 8601).

folder
object | null
required

Folder this content is organized in.

id
string
required

Unique identifier of the content.

page
object
required

Page this content belongs to.

markedAsPublishedAt
string | null
required

Timestamp of the 'mark as published' action, set by Semji (ISO 8601). Never editable. Use this one to detect publications.

publishedAt
string | null
required

Publication date declared by the author in the editor (ISO 8601). Day granularity, and it can be back or forward dated, so it does not tell when the content was actually published.

title
string | null
required

Title of the content.

type
enum<string>
required

Content type.

Available options:
DRAFT,
PUBLISHED,
ORIGINAL
updatedAt
string | null
required

ISO 8601 last update date.

wordsCount
integer | null
required

Number of words in the content.

contentUpdatedBy
object | null
required

User who last edited the content body.

html
string | null
required

HTML body of the content as authored in the Semji editor. May contain editor-only markers (comments, fact-check annotations) — for a clean version safe to publish externally, use htmlSanitized.

htmlSanitized
string | null
required

HTML body of the content with all Semji editor annotations (comments, fact-check markers) stripped. Safe to push into a CMS or publish externally.

isStarted
boolean
required

Whether the content has any HTML body.

lastGeneration
object | null
required

Last Atomic Content generation.

metaDescription
string | null
required

Meta description for SEO.

markedAsPublishedBy
object | null
required

User who ran the 'mark as published' action.

publishedBy
object | null
required
deprecated

Deprecated, use markedAsPublishedBy. Same value, kept so existing integrations keep working.

version
integer
required

Optimistic locking version.