# Screening Task Endpoints {#screening-task-endpoints}


Manage candidate screening tasks — assign evaluation tasks during the hiring process.


## Base Path {#base-path}


```
/api/screening-tasks
```


## Endpoints {#endpoints}



### List Screening Tasks {#list-screening-tasks}


```
GET /api/screening-tasks
Authorization: Bearer {token}
```


### Get Screening Task by ID {#get-screening-task-by-id}


```
GET /api/screening-tasks/:id
Authorization: Bearer {token}
```


### Create Screening Task {#create-screening-task}


```
POST /api/screening-tasks
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "Technical Assessment",
  "description": "Complete a coding challenge...",
  "status": "TODO",
  "dueDate": "2024-04-01",
  "candidateId": "candidate-uuid",
  "organizationId": "uuid"
}
```


### Update Screening Task {#update-screening-task}


```
PUT /api/screening-tasks/:id
Authorization: Bearer {token}
Content-Type: application/json

{
  "status": "COMPLETED",
  "result": "PASS"
}
```


### Delete Screening Task {#delete-screening-task}


```
DELETE /api/screening-tasks/:id
Authorization: Bearer {token}
```


## Data Model {#data-model}


```typescript
interface IScreeningTask {
  id: string;
  title: string;
  description?: string;
  status: ScreeningTaskStatusEnum;
  dueDate?: Date;
  result?: string;

  // Relations
  candidateId: string;
  candidate?: ICandidate;
  organizationId: string;
  tenantId: string;
}
```


## Related Pages {#related-pages}


- [Screening Tasks Feature](https://sourcey-gauzy.pages.dev/features/screening-tasks/index.md) — feature guide
- [Candidate Endpoints](https://sourcey-gauzy.pages.dev/api/candidate-endpoints/index.md) — candidate management
- [Recruitment Feature](https://sourcey-gauzy.pages.dev/features/recruitment/index.md) — ATS overview