Skip to main content
POST
Set my position

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

position_id
string

The position to edit or remove. Omit to add a new one.

Pattern: ^\d+$
delete
boolean

With position_id: remove the position instead of editing it.

title
string

Required on an add. LinkedIn's cap is 100.

Required string length: 1 - 100
company_name
string

Required on an add. Free text unless company_id names a LinkedIn company.

Required string length: 1 - 100
company_id
string

LinkedIn's numeric company id (lookup_linkedin_param_id with type company gives it).

Pattern: ^\d+$
employment_type_id
string

The form's employment type code: 12 Full-time, 11 Part-time, 3 Self-employed, 20 Freelance, 2 Contract, 18 Internship, 19 Apprenticeship, 21 Seasonal.

Pattern: ^\d+$
start_date
object

Required on an add.

end_date
object | null

Required on an add unless is_current is true.

is_current
boolean

The position is ongoing: no end date.

end_current_position_ids
string[]

Other current positions to end when this one becomes current.

Pattern: ^\d+$
location
string | null

The location as displayed, e.g. Buenos Aires, Argentina.

Maximum string length: 200
geo_location_id
string

LinkedIn's numeric geo id for the location.

Pattern: ^\d+$
location_type
enum<string>
Available options:
on_site,
remote,
hybrid
description
string | null

LinkedIn's cap is 2000.

Maximum string length: 2000
skills
string[]

Skill names, or ProfileSkill: ids the position read reports.

Required string length: 1 - 100
allow_profile_edit_broadcasts
boolean

Tell the network about the change (LinkedIn's "notify network" toggle). Default false.

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