Skip to main content

Roles

A role is a job opening you are hiring for. It is the top-level object in Gradient: you add a role first, Gradient builds one or more assessments under it, then you invite candidates to those assessments. Roles are separate from assessments on purpose, so the thing you are hiring for (the job) is not tangled up with the thing candidates do (the task).

Role vs. assessment

Role

The job opening. Holds the job description, the people involved (hiring manager and recruiter), and an optional link to the matching job in your ATS. Aggregates stats across all of its assessments.

Assessment

The work-sample test a candidate actually completes: a task brief, phases, a deliverable type, seeded data, and a scoring rubric. See Assessments.
One role can have many assessments (for example, a first-round screen and a deeper final round for the same opening). Gradient builds each assessment under a role, using the role’s job description as context.

What a role holds

Working with roles

You can create and edit roles in the dashboard or with the API. Enter a title and paste or link the job description. You can also import the role from a connected ATS job posting. To get an assessment for the role, email hi@trygradient.ai. After Gradient adds the assessment, link it to the role and invite candidates one at a time or in bulk. See Bulk invite.

Roles and your ATS

If you connect an applicant tracking system, you can seed roles directly from your live job postings and keep candidate records in sync. Roles are the object that links to an ATS job. See Integrations for how job import and the assessment-partner flow work.