Hirevanto API Assignments Framework

Hirevanto's Assignments framework allows third-party providers to integrate Hirevanto assignments into their platform.

This enables partners to initiate interviews, skills tests, and other assignments from the click of a button on their own third-party applications.

Overview

The Assignments API has two parts:

1. The API implemented by Hirevanto
2. The API implemented by the integration partner

General Flow

1. A Partner decides which assignment to send out.

   • Partner calls '/assignment.list' (Hirevanto API) to fetch available assignments.

2. The partner calls the Hirevanto API to trigger the assignment.

   • Partner calls '/assignment.start' (Hirevanto API) to trigger the assignment.

3. As the assignment progresses, the Hirevanto sends updates back to the partner.

   • Hirevanto calls '/assignment.update' (Partner API) to receive status updates.

4. At any time, the partner's user may cancel the assignment.

   • Partner calls '/assignment.cancel' (Hirevanto API) to cancel the assignment.

What Hirevanto Implements

GET /assignment.list

Purpose: List available assignment types.

• Called when a partner wants to present assignment options.
• This provides an ID reference to all the configured assignment types.

POST /assignment.start

Purpose: Start an assignment.

• Called by the partner when starting an assignment.
• Use the assignment type id to indicate which assignment type to use.

GET /assignment.status

Purpose: Manually get the status of an assignment - we recommend using the Webhook instead.

• Called by the partner when manually getting the status of an assignment.
• Use the assignment id to indicate which assignment to get the status of.

POST /assignment.cancel

Purpose: Cancel an ongoing assignment.

• Called by the partner if a customer opts to cancel an assignment.
• Use the assignment id to indicate which assignment to cancel.

What the Partner Implements

Partners must expose the following endpoints that will be called by Hirevanto:

POST /assignment.update

Purpose: As updates occur, Hirevanto will call this endpoint to notify the partner with the latest status and details for a started assignment.

• Partners will need to authenticate requests using the encoded api key provided.
• Requests must be sent over https.
• The base url for the Partner's API will need to be provided to the Hirevanto team as part of the onboarding process.

To learn more about the our API schema, view our API documentation.

API Documentation

View our API documentation