Skip to content

Trigger Scan

POST
/api/signals/scan
curl --request POST \
--url http://localhost:8000/api/signals/scan \
--header 'Authorization: Bearer <token>'

Trigger a signal scan on the durable queue worker.

The scan fans out to job-board providers (JobSpy etc.) per lead, which can take a long time and do blocking I/O — running it inline (or as a main-loop BackgroundTask) froze the API. We enqueue it on the queue worker (which runs handlers off the event loop in their own thread) and return immediately; the client polls GET /api/signals for results.

Successful Response

Media typeapplication/json
Examplegenerated
example