Skip to main content
PATCH
Update LinkedIn safety settings

Authorizations

X-API-Key
string
header
required

Path Parameters

profile_id
string<uuid>
required

Body

application/json
daily_limit_check_connections

Readings of the sender's newest connections a day, which notice accepted connection requests. Zero stops them.

Required range: 0 <= x <= 100
daily_limit_check_inbox
integer
Required range: 0 <= x <= 100
daily_limit_check_sent_invitations
integer
Required range: 0 <= x <= 100
daily_limit_connection_request
integer
Required range: 0 <= x <= 200
daily_limit_follow
integer
Required range: 0 <= x <= 200
daily_limit_like_post
integer
Required range: 0 <= x <= 200
daily_limit_profile_view
integer
Required range: 0 <= x <= 500
daily_limit_read_conversation
integer
Required range: 0 <= x <= 500
daily_limit_send_message

Messages and InMails a day, counted together.

Required range: 0 <= x <= 500
daily_limit_withdraw
integer
Required range: 0 <= x <= 200
min_action_interval_seconds

The least time between two steps on this account, in seconds, from 60 to 3,600. The gap actually waited is widened at random by up to 40%, so steps never land on an exact cadence.

Required range: 60 <= x <= 3600
run_mode

Whether a person approves a sender's LinkedIn steps before they run, or they run on their own.

The sender's own LinkedIn setting, kept on the sender beside their email modes so the approval queue reads one home for both. The absence of one (SenderProfileDTO.linkedin_approval_mode is None) reads as MANUAL: nothing runs on somebody's LinkedIn unattended until they have said so. The approval queue still tells "never set" apart from "chose manual", which is the level its settings surfaces name.

Available options:
manual,
auto
weekly_connection_request_cap
integer
Required range: 0 <= x <= 1000
weekly_limit_check_connections
integer | null
Required range: 0 <= x <= 700
weekly_limit_check_inbox
integer | null
Required range: 0 <= x <= 700
weekly_limit_check_sent_invitations
integer | null
Required range: 0 <= x <= 700
weekly_limit_follow
integer | null
Required range: 0 <= x <= 1400
weekly_limit_like_post
integer | null
Required range: 0 <= x <= 1400
weekly_limit_profile_view
integer | null
Required range: 0 <= x <= 3500
weekly_limit_read_conversation
integer | null
Required range: 0 <= x <= 3500
weekly_limit_send_message
integer | null
Required range: 0 <= x <= 3500
weekly_limit_withdraw
integer | null
Required range: 0 <= x <= 1400

Response

Successful Response

checkpoint_status
enum<string>
required

Whether LinkedIn is currently challenging this account.

Available options:
ok,
checkpoint
created_at
string<date-time>
required
daily_limit_check_connections
integer
required

Readings of the sender's newest connections a day: how accepted connection requests are noticed. Zero stops them.

daily_limit_check_inbox
integer
required
daily_limit_check_sent_invitations
integer
required
daily_limit_connection_request
integer
required
daily_limit_follow
integer
required
daily_limit_like_post
integer
required
daily_limit_profile_view
integer
required
daily_limit_read_conversation
integer
required
daily_limit_send_message
integer
required

Messages and InMails a day, counted together.

daily_limit_withdraw
integer
required
display_name
string
required
effective_run_mode
enum<string>
required

The approval setting in force for this sender's LinkedIn steps: their own, else manual. What the extension's side panel shows.

Available options:
manual,
auto
headline
string
required
id
string<uuid>
required
last_seen_at
string<date-time> | null
required
limit_maximums
LinkedInLimitMaximumsReadSchema · object
required

The most each limit above may be set to, under the same field names the settings update takes. A value above one is refused with a 422.

member_urn
string | null
required
min_action_interval_seconds
integer
required

The least time between two steps on this LinkedIn account, in seconds, before a random widening of up to 40% is added. It holds across every sequence the account sends for.

online
boolean
required
photo_url
string | null
required
presence
enum<string>
required

active: a browser checked in within the last couple of minutes. idle: seen within the last day. not_seen: no browser has checked in for a day.

Available options:
active,
idle,
not_seen
run_mode
enum<string> | null
required

The sender's own LinkedIn approval setting: manual (a person approves each step on Tasks before it is queued) or auto (steps are queued without asking). Null when it was never set, which runs as manual.

Available options:
manual,
auto
sender_profile_id
string<uuid>
required
status
enum<string>
required

Pairing lifecycle.

PENDING exists between "the user asked to connect" and "an extension actually bound a LinkedIn member to it", so the sender page can show a half-finished connection rather than nothing at all.

Available options:
pending,
active,
revoked
updated_at
string<date-time>
required
vanity_name
string | null
required
weekly_connection_request_cap
integer
required
approvals_waiting
integer
default:0

How many of this sender's LinkedIn steps wait for a person on Tasks, less those a paused sequence or paused contact holds.

connection_checks
LinkedInConnectionChecksReadSchema · object | null

How the readings of the sender's newest connections, which notice accepted connection requests, are doing. Older servers leave it out.

connection_token
string | null

What a person pastes into the extension to connect a browser. Several browsers may use it; Regenerate and Disconnect replace it.

queued_count
integer
default:0
replies_check
LinkedInRepliesCheckReadSchema · object | null

Whether the sender's inbox is being read for the messages that wait on it. Older servers leave it out.

sessions
LinkedInAgentSessionReadSchema · object[]

Every browser currently connected, most recent first.

usage
LinkedInKindUsageReadSchema · object[]
usage_resets_at
string<date-time> | null

When today's counts in usage start over: 00:00 in the sender's timezone. Older servers leave it out, and a client then reads the next UTC midnight.

wait
LinkedInWaitReadSchema · object | null

What the next step is waiting on, and until when; null while nothing is queued.

weekly_limit_check_connections
integer | null
weekly_limit_check_inbox
integer | null
weekly_limit_check_sent_invitations
integer | null
weekly_limit_follow
integer | null
weekly_limit_like_post
integer | null
weekly_limit_profile_view
integer | null
weekly_limit_read_conversation
integer | null
weekly_limit_send_message
integer | null
weekly_limit_withdraw
integer | null