Enrich person skills

Complete, paginated skills list (“Show all skills”) with endorsement counts (skill_id is the endorse handle). cached 7d. Use to see/reason over skills; to simply ENDORSE, use linkedin-accounts.endorse-skill (auto-discovers skills, no enrich call needed). A public_identifier-only call needs a stored URN.

Contract:

• MCP tool enrich_linkedin_person_skills, registry package mcp.linkedin/linkedin_enrichment, mount linkedin.enrichment.
• Operation action, response envelope action.
• Flags: none.

POST /api/linkedin-enrichment/person-skills

Enrich person skills

cURL

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "profile_id": "<string>",
  "public_identifier": "<string>",
  "page_size": 50,
  "cursor": "<string>",
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>"
}
'

200

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "skills": {
      "elements": [
        {
          "name": "<string>",
          "skill_id": "<string>",
          "urn": "<string>",
          "endorsement_count": 123
        }
      ],
      "paging": {}
    },
    "data_request": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<string>"
  }
}

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_person_skills.

profile_id · string

ln_id (ACoAA…) or sn_id (ACwAA…), interchangeable for dispatch. Provide profile_id XOR public_identifier.

Maximum string length: 128

public_identifier · string

Vanity slug from /in/…, or the whole profile URL it comes from (any linkedin.com host, locale or mwlite prefix, query and trailing slash included): the URL is reduced to the slug before dispatch, and both forms share one ledger entry. A linkedin.com URL that is NOT a profile URL is refused 422 public_identifier_not_resolvable instead of being sent as a slug. Provide public_identifier XOR profile_id. On sub-record methods a slug-only call needs a stored URN (run person-lite-profile first) or is refused not_dispatchable.

Maximum string length: 2048

page_size · integer

Items per page, 1..100 (wire default 10).

Required range: 1 <= x <= 100

cursor · string | null

Opaque cursor: pass back paging.next_page_cursor verbatim; omitted = first page.

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

Response

200

application/json

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

Show child attributes

meta · object · required

Show child attributes