# Tasks

Service orders, visits and field tasks.

## Retrieve a Task

 - [GET /tasks/{id}](https://developer.auvo.com.br/en/openapi/api-reference/tasks/retrieve-a-task.md): Returns the details of a Tasks record identified by its unique identifier.

## Edit a Task

 - [PATCH /tasks/{id}](https://developer.auvo.com.br/en/openapi/api-reference/tasks/edit-a-task.md): Updates the editable fields of an existing Tasks record. Only properties present in the request body are modified.

## Delete a Task

 - [DELETE /tasks/{id}](https://developer.auvo.com.br/en/openapi/api-reference/tasks/delete-a-task.md): Removes the relationship or Tasks record from your account. This operation cannot be undone.

## Add a new Task

 - [POST /tasks](https://developer.auvo.com.br/en/openapi/api-reference/tasks/add-a-new-task.md): Creates a Tasks record in your account using the data provided in the request body.

## Upsert - Add a new Task or update an existing one

 - [PUT /tasks](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-add-a-new-task-or-update-an-existing-one.md): Updates or replaces Tasks data using the payload provided in the request body.

## Retrieve a list of Tasks

 - [GET /tasks](https://developer.auvo.com.br/en/openapi/api-reference/tasks/retrieve-a-list-of-tasks.md): Returns a paginated list of Tasks registered in your account. Use query parameters to filter, sort and paginate results.

## Upsert Task Attachments

 - [PUT /tasks/{id}/attachments](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-task-attachments.md): Updates or replaces Tasks data using the payload provided in the request body.

## Upsert Task Products

 - [PUT /tasks/{id}/products](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-task-products.md): Updates or replaces Tasks data using the payload provided in the request body.

## Delete Task Products

 - [DELETE /tasks/{id}/products](https://developer.auvo.com.br/en/openapi/api-reference/tasks/delete-task-products.md): Removes the relationship or Tasks record from your account. This operation cannot be undone.

## Upsert Task Services

 - [PUT /tasks/{id}/services](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-task-services.md): Updates or replaces Tasks data using the payload provided in the request body.

## Delete Task Services

 - [DELETE /tasks/{id}/services](https://developer.auvo.com.br/en/openapi/api-reference/tasks/delete-task-services.md): Removes the relationship or Tasks record from your account. This operation cannot be undone.

## Upsert Task Additional Costs

 - [PUT /tasks/{id}/additional-costs](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-task-additional-costs.md): Updates or replaces Tasks data using the payload provided in the request body.

## Delete Task Additional Costs

 - [DELETE /tasks/{id}/additional-costs](https://developer.auvo.com.br/en/openapi/api-reference/tasks/delete-task-additional-costs.md): Removes the relationship or Tasks record from your account. This operation cannot be undone.

## Upsert Task Questionnaire Response

 - [PUT /tasks/{id}/questionnaire-response](https://developer.auvo.com.br/en/openapi/api-reference/tasks/upsert-task-questionnaire-responses.md): Creates or updates a questionnaire answer for a task.

The request is processed asynchronously. A 202 Accepted response means the answer was validated, queued and should be available in the task within up to 5 minutes. It does not guarantee that the final task record has already been updated when the response is returned.

Send one answer per request. The answer is upserted for the questionnaire instance identified by itemID, codigoChecklist and codigoPergunta; when the same checklist is attached to the task more than once, use a distinct itemID for each instance. Use codigoEquipamento when the questionnaire answer belongs to a specific task equipment.

## Retrieve a list of Deleted Tasks

 - [GET /tasks/GetDeletedTasks](https://developer.auvo.com.br/en/openapi/api-reference/tasks/retrieve-a-list-of-deleted-tasks.md): Returns a paginated list of Tasks registered in your account. Use query parameters to filter, sort and paginate results.