Skip to main content
POST
Endorse skill by id

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.

Path Parameters

sid
string
required

LinkedIn account sid (ln_ac_…).

Required string length: 18
Pattern: ^ln_ac_

Body

application/json

Request body of endorse_linkedin_account_skill_by_id.

target
object
required

Target person, by any identifier: at least one of ln_id / sn_id / recruiter_id / ln_member_id / nickname. The key the verb's wire takes is found for you: your team's own rows, then the stored corpus, then ONE lite profile read on the acting account; the answer says which (result.target_resolved_via: "ledger", "corpus", "browser", or null when the input already held the key).

skill_id
string
required

The skill id from a person-skills read (a numeric string on every proven id; LinkedIn owns the namespace).

Required string length: 1 - 64
client_reference
string | null

Your own reference for this action (a task id; max 255, never parsed). Stored on the action's activity log rows and a filter of search_linkedin_account_activity_log. When the target is named by a slug alone, the one profile read that finds its URN is keyed by it and the person (journaled as <client_reference>:resolve:<16 hex>), so a metering caller can pair that read with its task. Unlike a send's key it answers no repeat: a repeated call endorses again.

Maximum string length: 255

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
object | null
required
result
object
required
meta
object
required
pacing
object