Skip to main content
PATCH
Update a Social Selling draft

Authorizations

x-api-key
string
header
required

Path Parameters

draftId
integer
required

Draft id (draftId).

Body

application/json

Only the fields you send change; null clears a nullable field.

expectedVersion
integer
required

The version you edited (from the draft you read). A newer version answers 409 VERSION_CONFLICT.

identityId
integer
text
string

New text. Changing the text without sending mentions clears the mentions.

Maximum string length: 3000
title
string | null

Name in Enginy (never published). Defaults to the text’s first line when scheduled.

Maximum string length: 200
mentions
object[]
Maximum array length: 50
attachments
object[]

Ordered media by assetId: uploads (ssa_…, completed) or a tracked post’s media (spm_…, copied into the workspace when attached, keeping the source and credit). Up to 20 images, or one video, or one document; never mixed.

Maximum array length: 20
firstComment
string | null

Posted by the same person 30 seconds after the post goes live, on the published post (e.g. the link). null removes it.

Maximum string length: 1250
visibility
enum<string>

Who can see the post on LinkedIn. Default ANYONE.

Available options:
ANYONE,
CONNECTIONS
postAsCompany
boolean

Publish as a LinkedIn company page the identity administers (companyUrn required).

companyUrn
string | null

The company page’s numeric LinkedIn id.

Pattern: ^\d+$
sourceAttribution
string | null

Credit for a borrowed concept (kept with the draft and its media copies).

Maximum string length: 200
series
string | null

Content series (e.g. "City maps").

Maximum string length: 200
pillar
string | null

Content pillar (e.g. build in public, education, product, industry).

Maximum string length: 200
objective
string | null
Maximum string length: 200
audience
string | null
Maximum string length: 200
factualSources
string[] | null

Sources backing the facts in the post (URLs or references).

Maximum array length: 20
Required string length: 1 - 2000
notes
string | null
Maximum string length: 5000

Response

The draft at its new version

status
enum<string>
required
Available options:
success
message
string
required
data
object
required