<!-- Generated from the canonical OpenPost public page. Do not edit this build artifact. -->

Title: Publications and Renditions
Description: Create a draft, customize destinations, validate it, and publish it with the SDK.
Canonical: https://docs.openpo.st/automate/sdk/publications
Source: [https://docs.openpo.st/automate/sdk/publications](https://docs.openpo.st/automate/sdk/publications)

# Publications and Renditions

A Publication owns the source idea and lifecycle. A Rendition is the version for one connected account. Create a draft first, inspect it, then validate and schedule or publish it.

## Create a draft

```ts
const draft = await openpost.publications.create({
  workspace_id: openpost.workspaceId(),
  title: "Launch day",
  content_profile: "short_text",
  source_text: "We just shipped the new import flow.",
  social_account_ids: ["acc_linkedin", "acc_x"],
});
```

Omit `social_account_ids` to keep the draft without destinations. Pass `social_set_id` to copy that Social Set's accounts and saved destination defaults into the new Publication.

## Customize a destination

Read the current revision before changing Renditions. Send every Rendition you want to keep because this method replaces the saved destination set.

```ts
const linkedinOptions = await openpost.accounts.destinationOptions("acc_linkedin");
console.dir(linkedinOptions, { depth: null });

const saved = await openpost.publications.upsertRenditions(draft.id, draft.revision, [
  {
    social_account_id: "acc_linkedin",
    body: "We shipped a faster import flow. Read the release notes:",
    settings: { url: "https://example.com/releases/imports" },
  },
  {
    social_account_id: "acc_x",
    body: "The new import flow is live.",
  },
]);
```

Resolve `accounts.destinationOptions(accountId)` before constructing provider-specific settings. It returns the current keys and choices for that account. OpenPost returns a conflict when an account has multiple subdestinations and the Rendition does not include a `target_key`.

## Validate and publish now

```ts
await openpost.publications.validate(saved.id, { throwOnInvalid: true });

const action = await openpost.publications.publishNow(saved.id, saved.revision);
if (action.job_id) {
  await openpost.jobs.wait(action.job_id);
}
```

To publish later, set `scheduled_at` with `create()` or `update()`, then call `schedule()` with the latest revision. A scheduled job remains pending until that time, so do not call `jobs.wait()` in a short-lived request. `publishNow`, `schedule`, `cancel`, and `remove` take the revision you last read. This prevents a stale process from overwriting a newer edit. `retryFailed` retries failed Renditions without republishing successful ones.

## Read the outcome

```ts
const result = await openpost.publications.wait(saved.id, {
  timeoutMs: 120_000,
  intervalMs: 2_000,
});

for (const rendition of result.renditions) {
  console.log(rendition.platform, rendition.status, rendition.external_url);
}
```

Do not treat a queued job as proof of provider delivery. Read the final Publication, its Renditions, or `publications.events(id)`.