Publish one or more documents

post

https://api.seismic.com/integration/v2/teamsites/{teamsiteId}/publish

Immediately publishes or schedules publication of up to 10 unpublished Library documents within the specified teamsite. Each document in the content array is identified by its library content id. The endpoint always publishes the latest version of each document, transitioning its status from Draft to Published.

To schedule a future publish, supply a publishAt value in YYYY-MM-DD HH:MM AM|PM or YYYY-MM-DD format. All times are processed in UTC. When publishAt is omitted, the documents are published immediately.

Set IsSendNotification to true to notify subscribers when the content is published.

📘
Where do documents get published?
Documents are published to the profiles with Dynamic Folders that automatically detect the content based on the content's metadata and content properties. This endpoint does not currently support a parameter to publish to specific profiles.
To create a dynamic folder from within your tenant:

Navigate to Profile Builder

Select the teamsite from the dropdown list

Click on the profile

Click on the + sign on the top right side - add dynamic folder(if this folder does not exist)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

teamsiteId

string

required

Identifier of the teamsite context for the request. Depending on API behavior, it may be a GUID-formatted value or a documented special value such as 1.

Body Params

JSON object containing the list of documents to publish, an optional scheduled publish date, an optional comment, and a notification flag.

Request body for publishing one or more Library documents. Supports immediate publishing or scheduled publishing with an optional notification flag.

comment

string

An optional comment to associate with the publish action, visible in content history.

publishAt

string

Optional scheduled publish date. Accepts either YYYY-MM-DD HH:MM AM|PM (date with time) or YYYY-MM-DD (date only). All times are processed in UTC. Omit to publish immediately.

IsSendNotification

boolean

Defaults to true

Whether to send a notification to subscribers when the content is published. Defaults to true when omitted, matching the backend PublishRequest.IsSendNotification default. Set to false to publish silently without notifying subscribers.

content

array of objects

length between 1 and 10

An array of content items to publish. Each item must include a valid library content id. The documented maximum of 10 items per request applies to immediate (unscheduled) publishing; when publishAt is supplied for scheduled publishing the backend accepts up to 50 items. The array is required and must contain at least one item.

content

A reference to a single library content item to publish.

string

The unique identifier of the library content item to publish.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK. Returns a summary of the publish operation including counts for total requests, successes, errors, and warnings, along with detail arrays for any content items that encountered errors or warnings.

400Bad Request. The teamsiteId is malformed or the request body is invalid

401Unauthorized. The request is missing a bearer token, or the token is invalid or expired.

403Forbidden. The caller is authenticated but does not have permission to publish content.

404Not Found. The targeted teamsite, folder, file, item, or workflow could not be located by the provided identifier.

500Internal Server Error. An unexpected server-side error occurred while processing the request.

504Gateway Timeout. The upstream service did not respond in time, or is temporarily unavailable. Safe to retry after a brief delay.