HiringMay change state
Save Hiring Candidate
save_hiring_candidate
Create or update one authorized private recruiting record, optionally assigned to a company job. Supply stable ID, observed version, source and authority. Never infer an account link from email. A prospect is not an application. Archiving is reversible and is not erasure, withdrawal or external deletion.
Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.
Parameters
| Name | Contract |
|---|---|
client_idRequired | string |
idRequired | string |
expected_versionRequired | integer |
nameRequired | string |
emailOptional | See schema |
job_idOptional | See schema |
resume_textOptional | string |
relationshipRequired | string Values: prospect, application_reported |
source_labelRequired | string |
authority_statementRequired | string |
source_use_authorizedRequired | boolean |
applied_atOptional | See schema |
private_noteOptional | string |
stateOptional | string Values: active, archived |
Exact input schema
Expand JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"client_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"expected_version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{
"type": "null"
}
]
},
"job_id": {
"default": null,
"anyOf": [
{
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
{
"type": "null"
}
]
},
"resume_text": {
"default": "",
"type": "string",
"maxLength": 50000
},
"relationship": {
"type": "string",
"enum": [
"prospect",
"application_reported"
]
},
"source_label": {
"type": "string",
"minLength": 3,
"maxLength": 500
},
"authority_statement": {
"type": "string",
"minLength": 20,
"maxLength": 2000
},
"source_use_authorized": {
"type": "boolean",
"const": true
},
"applied_at": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"private_note": {
"default": "",
"type": "string",
"maxLength": 3000
},
"state": {
"default": "active",
"type": "string",
"enum": [
"active",
"archived"
]
}
},
"required": [
"client_id",
"id",
"expected_version",
"name",
"relationship",
"source_label",
"authority_statement",
"source_use_authorized"
],
"additionalProperties": false
}Output schema
Expand output contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{
"type": "null"
}
]
},
"job_id": {
"default": null,
"anyOf": [
{
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
{
"type": "null"
}
]
},
"resume_text": {
"default": "",
"type": "string",
"maxLength": 50000
},
"relationship": {
"type": "string",
"enum": [
"prospect",
"application_reported"
]
},
"source_label": {
"type": "string",
"minLength": 3,
"maxLength": 500
},
"authority_statement": {
"type": "string",
"minLength": 20,
"maxLength": 2000
},
"source_use_authorized": {
"type": "boolean",
"const": true
},
"applied_at": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"private_note": {
"default": "",
"type": "string",
"maxLength": 3000
},
"state": {
"default": "active",
"type": "string",
"enum": [
"active",
"archived"
]
},
"version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"created_at": {
"type": "string"
},
"created_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"updated_at": {
"type": "string"
},
"updated_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"linked_applicant": {
"type": "boolean",
"const": false
},
"delivery": {
"type": "string",
"const": "not_an_afina_submission"
},
"audience": {
"type": "string",
"const": "recruiter_only"
},
"notice": {
"type": "string"
}
},
"required": [
"client_id",
"id",
"name",
"email",
"job_id",
"resume_text",
"relationship",
"source_label",
"authority_statement",
"source_use_authorized",
"applied_at",
"private_note",
"state",
"version",
"created_at",
"created_by",
"updated_at",
"updated_by",
"linked_applicant",
"delivery",
"audience",
"notice"
],
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false
}Tool annotations
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false
}