application

Reject or hire candidates

Records a decision on one or more applications (up to 50): rejected, with a reason (not_a_fit, role_filled, withdrew, no_response, or other with a note) and optionally the rejection email; or hired, which makes the candidate an employee party. The person and the time are recorded. An agent's or an API key's call returns approval_required; a person approves each candidate with a passkey. Rejected applications are deleted after the company's retention period.

post/applications/decide

Request

  • Base URL: https://localhost:4410/api/v1
  • URL: https://localhost:4410/api/v1/applications/decide
  • Auth: HTTP bearer

Request body

application_idsstring[] required
outcome'rejected' | 'hired' required
reason'not_a_fit' | 'role_filled' | 'withdrew' | 'no_response' | 'other'
notestring

Response

The result.

Changes

No recorded changes to this operation across all 1 revision of this API.