# Projects

Endpoints for project management

## Create a project

 - [POST /projects](https://hypatos.redocly.app/openapi/projects/projectscreate.md): Creates a project based on the request

## Retrieve a projects list for given search criteria

 - [GET /projects](https://hypatos.redocly.app/openapi/projects/projectslist.md)

## Retrieve a project by id

 - [GET /projects/{id}](https://hypatos.redocly.app/openapi/projects/projectsgetbyid.md): Retrieve a project by id

## Update a project

 - [PATCH /projects/{id}](https://hypatos.redocly.app/openapi/projects/projectsupdate.md): Update a project by id. This endpoint supports partial updates using PATCH semantics:
- Only fields present in the request will be updated
- Null values will clear optional fields (note, retentionDays)
- Absent fields will remain unchanged
- Required fields (name, extractionModelId, ocr, completion, duplicates, isLive, members, schema) cannot be set to null
- At least one field must be provided in the request

## Retrieve a schema by project id

 - [GET /projects/{id}/schema](https://hypatos.redocly.app/openapi/projects/schemasgetbyprojectid.md): Retrieve a schema by project id