# EPGP recruits

## `GET /api/epgp/recruits`

**List EPGP recruits**

Returns every recruiting candidate, newest first.

**Response `200` — The recruiting candidates.**

Model: {ref}`EpgpRecruitList <model-epgprecruitlist>`

| Field | Type | Required | Description |
|---|---|---|---|
| `recruits` | array of {ref}`EpgpRecruitRow <model-epgprecruitrow>` | yes |  |


## `PUT /api/epgp/recruits/{recruit_id}`

**Update an EPGP recruit**

Updates a recruit's status, note, or checklist. Only the fields present are changed.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `recruit_id` | path | string (uuid) | yes | The recruit's ID. |

**Request body**

Model: {ref}`EpgpRecruitUpdate <model-epgprecruitupdate>`

| Field | Type | Required | Description |
|---|---|---|---|
| `status` | {ref}`RecruitStatus <model-recruitstatus>` \| null | no |  |
| `note` | string \| null | no |  |
| `checklist` | {ref}`RecruitChecklist <model-recruitchecklist>` \| null | no |  |

**Response `200` — The recruit's updated record.**

Model: {ref}`EpgpRecruitRow <model-epgprecruitrow>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `character` | string | yes |  |
| `class` | {ref}`WowClass <model-wowclass>` \| null | no |  |
| `status` | {ref}`RecruitStatus <model-recruitstatus>` | yes |  |
| `note` | string \| null | yes |  |
| `checklist` | {ref}`RecruitChecklist <model-recruitchecklist>` | yes |  |
| `votes` | array of {ref}`ExportRecruitVote <model-exportrecruitvote>` | yes |  |
| `member_id` | integer \| null | yes |  |
| `at` | string (date-time) | yes |  |


## `POST /api/epgp/recruits/{recruit_id}/votes`

**Vote on an EPGP recruit**

Adds or replaces the signed-in officer's vote on a recruit.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `recruit_id` | path | string (uuid) | yes | The recruit's ID. |

**Request body**

Model: {ref}`EpgpRecruitVoteCreate <model-epgprecruitvotecreate>`

| Field | Type | Required | Description |
|---|---|---|---|
| `vote` | {ref}`RecruitVoteChoice <model-recruitvotechoice>` | yes |  |

**Response `201` — The recruit's updated record.**

Model: {ref}`EpgpRecruitRow <model-epgprecruitrow>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `character` | string | yes |  |
| `class` | {ref}`WowClass <model-wowclass>` \| null | no |  |
| `status` | {ref}`RecruitStatus <model-recruitstatus>` | yes |  |
| `note` | string \| null | yes |  |
| `checklist` | {ref}`RecruitChecklist <model-recruitchecklist>` | yes |  |
| `votes` | array of {ref}`ExportRecruitVote <model-exportrecruitvote>` | yes |  |
| `member_id` | integer \| null | yes |  |
| `at` | string (date-time) | yes |  |