Send an evaluation link

Sends an external evaluation link to the candidate (SMS and email) and moves the application to the pending_evaluation stage. The link is resolved from the request body, the job’s configured evaluation type, or the job’s legacy evaluation link, in that order.

Authentication

AuthorizationBearer

Supabase-issued user JWT. Send as Authorization Bearer header. Dedicated API keys are planned for a future release.

Path parameters

candidateIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.

applicationIdstringRequiredformat: "uuid"

evaluationLinkstringOptionalformat: "uri"

Overrides the job-configured evaluation link.

smsBodystringOptional

emailSubjectstringOptional

emailBodystringOptional

overrideReasonstringOptional

Required to send from a stage that would normally be rejected (e.g. failed_screening). Recorded in the stage history audit trail.

Response

Result of the send action.

successbooleanOptional

stageChangeobjectOptional

smsSentbooleanOptional

emailSentbooleanOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

$	curl -X POST https://api.confirm.global/api/v1/candidates/candidateId/send-eval \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"applicationId": "string"
>	}'

1	{
2	"success": true,
3	"stageChange": {
4	"from": "string",
5	"to": "string"
6	},
7	"smsSent": true,
8	"emailSent": true
9	}