Skip to main content
GET
Connected Accounts
Each account read returns its status, grant, idle deadline, and sync coverage. Free, proof-signed. Accounts are owner-scoped: another agent’s account id returns 404. Account reads expose little. They never include the upstream provider’s account reference, LinkedIn’s internal member id, or any hosted URL. The only LinkedIn-side identifier returned is member_urn, the human’s public profile slug (the part after linkedin.com/in/), so you can show which account is connected. id is OneShot’s account id, which every other endpoint takes.

Endpoints

Account shape

status

grant_version increments whenever the grant changes (narrowing on reconnect, revoke). Writes queued under an older version are cancelled at execution instead of sent.

Revoke

Revoke ends the grant immediately and stops the upstream bill. DELETE /v1/tools/linkedin/accounts/{id} does the following:
  • allowed_actions becomes empty and grant_version increments.
  • Every pending write is cancelled and its job fails with grant_revoked (eligible for the failed-job refund sweep). A write already executing is left to the worker’s own check.
  • Open reconnect links are cancelled.
  • The upstream connection is deleted so it stops billing (the lifecycle sweep retries if the provider is down).
  • Stored conversations and messages are kept for 30 days for audit, then purged.
Revoking twice returns 200 and does nothing.

Idle policy

An unused account revokes itself. Any owner-authorized read of the account updates last_authorized_call_at (at most hourly). Twenty-three days without one sets a warning. Thirty days revokes the account automatically (revoked_reason: idle) so an unused connection stops costing money. idle_revoke_at on every read shows when that would happen.

Invitation limits

The single-account endpoint includes limits.invites: limit (default 25), used, pending (queued reservations), remaining, and resets_at (next midnight UTC). Withdrawn invitations retain their original daily usage. Pending acceptance does not consume another day’s allowance. These limits cover OneShot API activity, not browser or external-tool activity.