> ## Documentation Index
> Fetch the complete documentation index at: https://trygradient.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How roles organize hiring in Gradient

> A role is the job you're hiring for, and assessments sit under it. See what a role holds and how it links to assessments and your ATS.

# 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

<CardGroup cols={2}>
  <Card title="Role" icon="briefcase">
    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.
  </Card>

  <Card title="Assessment" icon="clipboard-check">
    The work-sample test a candidate actually completes: a task brief, phases, a deliverable
    type, seeded data, and a scoring rubric. See [Assessments](/docs/concepts/assessments).
  </Card>
</CardGroup>

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

| Field | Description |
| - | - |
| Title | The role name, for example "Senior Product Manager". |
| Job description | Pasted text or a link. Gradient uses it when it builds your assessments. |
| Hiring manager | The workspace member who owns the role. |
| Recruiter | The workspace member running the search. |
| ATS-linked job | An optional link to the matching job in Ashby, Greenhouse, or Workday. See [Integrations](/docs/integrations). |
| Stats | Rolled up across the role's assessments: how many assessments exist and how many distinct candidates have been invited. |

## 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](mailto: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](/docs/guides/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](/docs/integrations) for how job import and the assessment-partner flow work.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.