Skip to main content
POST
Re-queues discovery for either a people or company Target. This is not limited to the dashboard’s “Couldn’t finish” state.

Request

string
required
Target UUID.
No query parameters or body. If a pending or running job already exists for this Target, the service does not insert another job and returns the current Target. Otherwise it inserts track_people for a people Target or track_company for a company Target. The new job starts with phase queued.

Response

202 Accepted returns { "data": Target }, with the current counts and latest job summary. 202 means a job is pending or already active; it does not mean discovery or enrichment completed. job.id, job.phase, and job.error are nullable; linkedin_url is nullable for people Targets and unresolved companies.

Examples

Lifecycle, retry safety, and recovery

The worker discovers members, preserves existing member status on URL conflicts, enriches watching members, and records the latest job’s progress. It may internally retry failed enrichment rounds, but the API does not provide a completion time or monitoring freshness guarantee. A Target can finish with job.status: "done" and a non-zero job.failed count; inspect job.error. A repeated request while a job is pending or running is usually a no-op at the service layer. It is still a POST without an idempotency key, and a timeout can occur before the caller sees whether the job was inserted. After an uncertain response, Get target and compare the latest job before retrying. Do not use retry as a polling loop; read the Target instead.

Errors

  • 401 unauthorized, 402 payment_required, and platform-key 400 invalid_request: fix authentication, access, or the required organization header.
  • 404 not_found: the Target does not exist in the authenticated organization. Do not retry unchanged.
  • 409 conflict: the route preserves a service conflict if returned; reconcile the Target and latest job before another write.
  • 429/5xx: back off. For an uncertain POST, reconcile first rather than blindly creating another job.

Next