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

# Fast-track

> Read and set a candidate's ParaAI fast-track opt-in.

Fast-track is a per-candidate opt-in, the same setting as the in-app **Fast-track this candidate** toggle. It's stored per candidate per owning recruiter.

When a hiring manager shows interest in a ParaAI match for a fast-tracked candidate, Paraform emails the candidate directly with a link to review the role and self-submit. The owning recruiter is CC'd and notified, and keeps full ownership of the candidate. Without the opt-in, only the recruiter is notified.

## The opt-in is stored, not acted on

Setting fast-track changes nothing right away. Paraform re-checks every precondition at the moment a hiring manager shows interest:

* The owning recruiter is enabled for fast-track.
* The candidate isn't off the market.
* A contact email is on file.
* The recruiter-entered work preferences are complete.

If any of these fails at that moment, the recruiter-only flow runs instead.

## Read

[`GET /talent-network/candidates/{candidateUserId}/fast-track`](/agency/api-reference/get-talent-network-candidate-fast-track) (`talent_network:read`):

```bash theme={null}
curl "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/fast-track" \
  -H "Authorization: Bearer $PARAFORM_API_KEY"
```

```json theme={null}
{ "candidateUserId": "clx8k2j3a0000qz8h1b2c3d4e", "fastTrack": true, "offMarket": false }
```

`offMarket` is `true` while the candidate is explicitly off the market. The opt-in is still stored and returned, but it won't fire until they're back on the market.

## Set

[`PUT /talent-network/candidates/{candidateUserId}/fast-track`](/agency/api-reference/set-talent-network-candidate-fast-track) (`talent_network:write`, `write` rate tier):

```bash theme={null}
curl -X PUT "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/fast-track" \
  -H "Authorization: Bearer $PARAFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "fastTrack": true }'
```

The response echoes the stored state and matches a later `GET`. The write is accepted while the candidate is off the market, and `offMarket: true` in the response tells you it won't fire yet. Retries converge on the same state, so no `Idempotency-Key` is needed.

## Who can read and write

`candidateUserId` comes from the [membership list](/agency/guides/network-membership), `lookup`, or batch items.

| Situation | Result |
| - | - |
| The candidate is owned by an approved member of your agency | Readable |
| Another agency's `candidateUserId` | `404`, the same as an id that doesn't exist |
| Fast-track isn't enabled for the candidate's owning recruiter | `403` on both read and write. This is a Paraform-side setting the API can't change. |
| Writing a candidate the key's creator doesn't own | `403`, even for agency owners |

<Warning>
  Writes are bound to the recruiter who **created the API key**: a key can only set fast-track on that recruiter's own candidates. To change another recruiter's candidates, use a key that recruiter created on the **API Keys** tab. The key list shows who created each key.
</Warning>


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