# Views

Views are saved configurations for displaying Records that define filters, sorting, visible properties (show), grouping, calculations, row heights, and display traits (table, flow). Views enable users to create custom perspectives on data (e.g., "My Active Candidates", "High Priority Vacancies", "Recent Applications"). Each View belongs to a CaraerObject and specifies how Records of that Object should be displayed. Views can be shared with other users, set as default views, and include query strings for search functionality. Views support different traits like Table (tabular display), Flow (kanban-style workflow), and can include calculations for aggregated data. Views improve UX by allowing users to bookmark common queries and share them with team members, ensuring consistent data presentation across the platform.

## Get view details

 - [GET /api/v2/objects/{objectUuid}/views/{viewUuid}](https://developer.caraer.com/apis/views/getview.md): Retrieves detailed information for a view identified by its UUID for the specified object. Returns a ShowResponse containing the ViewDTO.

## Update an existing view

 - [PUT /api/v2/objects/{objectUuid}/views/{viewUuid}](https://developer.caraer.com/apis/views/updateview.md): Updates the details of an existing view identified by its UUID for the specified object. The request body must contain the updated view details as a ViewDTO. Returns an UpdateResponse with the updated view data.

## Delete a view

 - [DELETE /api/v2/objects/{objectUuid}/views/{viewUuid}](https://developer.caraer.com/apis/views/deleteview.md): Deletes the view identified by its UUID from the specified object. Returns a DeleteResponse confirming the deletion.

## Restore a deleted view

 - [PATCH /api/v2/objects/{objectUuid}/views/{viewUuid}](https://developer.caraer.com/apis/views/patchview.md): Restores a soft-deleted view identified by its UUID for the specified object. Returns a RestoreResponse containing the restored view details.

## Toggle view favorite status

 - [PUT /api/v2/objects/{objectUuid}/views/{viewUuid}/favorite](https://developer.caraer.com/apis/views/favoriteview.md): Toggles the favorite status of the specified view. Returns an UpdateResponse containing the updated view details.

## Update view indices

 - [PUT /api/v2/objects/{objectUuid}/views/updateIndices](https://developer.caraer.com/apis/views/updateindices_1.md): Updates the indices for views associated with the specified object. The request body must include a mapping of view UUIDs to their new index values. Returns a SuccessResponse with the updated view DTOs.

## Fetch paginated views for an object

 - [POST /api/v2/objects/{objectUuid}/views/index](https://developer.caraer.com/apis/views/getviews.md): Retrieves a paginated list of views for the specified object. A custom Cypher query is used to filter views based on the object's UUID. Returns a PaginationResponse containing ViewDTO objects.

## Create a new view

 - [POST /api/v2/objects/{objectUuid}/views/](https://developer.caraer.com/apis/views/createview.md): Creates a new view for the specified object. The request body must contain the view details as a ViewDTO. Returns a CreateResponse containing the newly created view as a ViewDTO.