Skip to main content
POST
Enrich post details

Authorizations

Authorization
string
header
required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of enrich_linkedin_post_details.

post_urn
string

The post handle, in any family the wire takes: urn:li:activity:, urn:li:share:, urn:li:ugcPost:, urn:li:groupPost:-, or a bare id (digits = activity, digits-digits = groupPost). Provide post_urn XOR url.

Maximum string length: 128
url
string

Any post URL, a lnkd.in shortlink included. A feed permalink or a slug link carrying the id (activity or ugcPost family) resolves locally, one round trip; a shortlink is expanded server-side first (this is the form Copy link to post mints) and then resolves the same way; a linkedin.com link with NO id in it is fetched by the link itself, also one round trip. Provide url XOR post_urn.

Maximum string length: 2048
linkedin_account_sid
string | null

Executor account (ln_ac_...). Given: the call runs on that account ONLY; a saturated or held enrichment bucket refuses 429 bucket_saturated (with retry_after). Omitted: the service auto-picks one of your connected accounts with remaining capacity (422 no_connected_accounts when none is ready, 429 when all are at capacity).

Required string length: 18
Pattern: ^ln_ac_
idempotency_key
string | null

Replay guard (team_sid, idempotency_key). A repeat with the same key returns the stored ledger outcome: no re-execution.

Maximum string length: 128
trust_cache_max_age_days
integer | null

Accept a stored payload this many days old instead of fetching (probe tier 2, §9.5): a hit answers with served_from_cache / cache_source "data_cluster", spending no browser run and no bucket slot. Omitted, the stored payload is never consulted and the call always dispatches.

Required range: 1 <= x <= 3650

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required