Skip to Content
InvyteDocs
Talent Hub & sourcing

View a sourcing run

One External discovery run of a Job and the people it found: where they work, how well they matched, and whether they were invited or applied.

POST
/operations/sourcing.getRun

Authorization

bearer
headerAuthorizationBearer <API key or OAuth token>

An organization API key (ink_live_…, ADR-0124), or the OAuth access token a person's AI client gets from the Recruiter MCP sign-in. Only the Authorization header is accepted.

Header Parameters

Idempotency-Key?string

Makes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.

Match^[A-Za-z0-9._:-]+$
Length8 <= length <= 128

Request Body

application/json
  1. body
input*
confirmation?string

The id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.

Response Body

Done. A replay of the same key and input omits output.

application/json
  1. response
status*unknown
output?
actionId*string
Example Request
curl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/sourcing.getRun' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string",    "runId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "run": {      "id": "string",      "reason": "string",      "status": "string",      "resultCount": 0,      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    },    "prospects": [      {        "id": "string",        "personKey": "string",        "sourcingRunId": "string",        "name": "string",        "anonymous": true,        "title": "string",        "company": "string",        "location": "string",        "seniority": "string",        "years": 0,        "status": "string",        "closedReason": "string",        "source": "string",        "matchScore": 0,        "contactOnFile": {          "email": true,          "phone": true,          "linkedin": true        },        "applicationId": "string",        "invitation": {          "deliveryStatus": "string",          "deliveredAt": "2019-08-24T14:15:22Z",          "visitCount": 0,          "expiresAt": "2019-08-24T14:15:22Z"        },        "foundAt": "2019-08-24T14:15:22Z"      }    ],    "total": 0,    "nextCursor": "string"  },  "actionId": "string"}

Check top matches with UMatch POST

UMatch reads every résumé in a Job's Talent Hub matches not yet checked, closest first, against the Job's requirements, as the Sourcing tab's "Check with UMatch" does. Each new person uses one of the Job's daily UMatch checks and the check stops when they run out; people already checked are free. The result counts the people queued for UMatch apart from those already judged (none yet when it answers); judgements land in talent.matchesForJob as they finish.

Invite a prospect to apply POST

Email a Sourcing prospect for this Job an invitation to apply. They apply like anyone else; nothing is shared or created until they do.