Read the brief, record sender health, heartbeat, schedules, runs and observed replies, claim, start or report a LinkedIn action
Health observations record genuine sender measurements, never contact touches or send permission. Use null for unknown metrics; never invent healthy values. Counts must describe the same completed invitation cohort. Evidence expires after 24 hours; replaying an observation ID does not refresh it. Execute only after a successful start response, only once, using the exact copy it returns. Stop for login or CAPTCHA. Report outcome_unknown after an ambiguous browser result; never blindly retry. The server owns sequence advancement. Engine actions (source engine, planned by the parallel LinkedIn engine for the account named by setup) are claimable only when that account's automation mode and windows allow; a 409 names the reason and the next window. A persistent agent (a ChatGPT Dot or any always-on client) starts every run with command brief: it returns the account, its automation windows, today's remaining limits, how many actions are claimable now, whether a person asked for a reconnect, the event names it can subscribe to, and the current instructions with a version. It reports its recurring schedules with schedule_report (RFC 5545 RRULE lines with a time zone, plus how often it checks in), each run with run_report (idempotent on runId), and replies, received messages and accepted invitations it observed with sync (idempotent on externalKey; a reply is logged like a rep-logged reply and stops the engine's open work for that contact; an unmatched profile is recorded without its excerpt). When a person asks for a reconnect, acknowledge with reconnect_ack, then ask the owner to sign in through your private sign-in form or by taking over your browser, never by typing or receiving their password, and send a ready heartbeat; that heartbeat resolves the request. None of brief, schedule_report, run_report, sync or reconnect_ack sends, approves, creates, edits or completes an action; a result with its lease token is the only way an action completes.
Request
- Base URL: https://www.sagaris.ai/api/v1
- URL: https://www.sagaris.ai/api/v1/linkedin/actions
- Auth: HTTP bearer
Request body
Response
Recorded transition, brief, report or per-observation sync result
Changes
No recorded changes to this operation across all 2 revisions of this API.