Skip to Content
InvyteDocs

Talent Hub matches for a Job

The people in Your Talent Hub and the Invyte Network who best fit a Job, best first, with why they rank there and any UMatch judgement that still stands. Free: it ranks, it never judges.

POST
/operations/talent.matchesForJob

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/talent.matchesForJob' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "channels": {      "yourTalentHub": true,      "invyteNetwork": true    },    "people": [      {        "card": {          "key": "string",          "name": "string",          "anonymous": true,          "title": "string",          "company": "string",          "location": "string",          "summary": "string",          "skills": [            "string"          ],          "experience": [            {              "title": "string",              "company": "string",              "location": "string",              "startDate": "string",              "endDate": "string",              "isCurrent": true,              "highlights": [                "string"              ]            }          ],          "education": [            {              "institution": "string",              "degree": "string",              "date": "string",              "location": "string"            }          ],          "scope": "YOUR_TALENT_HUB",          "hasAccount": true,          "years": 0,          "seniority": "string",          "identity": "VERIFIED",          "contactOnFile": {            "email": true,            "phone": true,            "linkedin": true          },          "evidence": {            "interviews": 0,            "assessments": 0,            "items": [              {                "kind": "INTERVIEW",                "name": "string",                "completedAt": "2019-08-24T14:15:22Z",                "job": {                  "id": "string",                  "title": "string"                },                "otherOrganization": true              }            ]          }        },        "rank": 1,        "channel": "YOUR_TALENT_HUB",        "priorInterview": {          "title": "string",          "completedAt": "2019-08-24T14:15:22Z"        },        "umatch": {          "tier": "string",          "score": 0,          "reasons": [            "string"          ],          "requirements": [            {              "text": "string",              "dealbreaker": true,              "verdict": "string",              "lowConfidence": true            }          ],          "scoredAt": "2019-08-24T14:15:22Z"        },        "checkable": true,        "alsoInExternalDiscovery": true,        "fit": {          "matchedSkills": [            "string"          ],          "narrowerSkills": [            "string"          ],          "jobSkills": 0,          "years": 0,          "minYears": 0,          "seniority": "below",          "locationMatches": true,          "jobPlaces": [            "string"          ],          "clearsFloor": true        }      }    ],    "toCheck": {      "YOUR_TALENT_HUB": 0,      "INVYTE_NETWORK": 0,      "ALL": 0    },    "alreadyApplied": 0  },  "actionId": "string"}