v1

Start a Person Intelligence snapshot (scope write:intelligence)

Explicit refresh (2026-10-06): if a snapshot for this person exists it is returned with cached: true (200) however old it is, and nothing is spent, until refresh: true is sent. A refresh is honoured once the newest snapshot is 7 days old; before that the same snapshot is returned with refreshAvailableAt. A new run (202) spends credits and requires an active workspace. For ongoing weekly checks use /api/v1/intelligence/monitoring.

post/api/v1/intelligence/people

Request

  • Base URL: https://api.signalraven.ai
  • URL: https://api.signalraven.ai/api/v1/intelligence/people
  • Auth: HTTP bearer

Request body

personUrlstring required

A LinkedIn profile URL (/in/<slug>).

sourceCompanyReportIdstring uuid

Optional Account Intelligence report this person came from (must be in your workspace; 404 otherwise).

refreshboolean

Ask for a new report. Without it the newest ready report is returned (cached: true) however old it is. A refresh is honoured only once that report is 7 days old; before that the same report is returned with refreshAvailableAt. A refresh spends credits like a first run.

Response

Existing snapshot returned (nothing spent)

Changes

No recorded changes to this operation across all 1 revision of this API.