---
title: "Atualizar tarefa"
method: PUT
path: "/tasks/{id}"
tags: ["crm-v2-tasks"]
---

# Atualizar tarefa

`PUT /tasks/{id}`

## Request

- Base URL: `https://api.rd.services/crm/v2`
- URL: `https://api.rd.services/crm/v2/tasks/{id}`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

Atualiza os campos de uma tarefa, como seu assunto, data ou status de conclusão.

## Path parameters

- `id` string, required

## Request body

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Assunto da tarefa.
    - `description` string: Notas ou descrição adicional da tarefa.
    - `type` 'call' | 'email' | 'meeting' | 'task' | 'lunch' | 'visit' | 'whatsapp': Tipo da tarefa.
    - `status` 'open' | 'completed' | 'canceled': Status da tarefa.
    - `due_date` string, date-time: Data limite para conclusão da tarefa.
    - `created_by_id` string: ID do usuário que criou a tarefa.
    - `completed_at` string, date-time: Data em que a tarefa foi concluída.
    - `completed_by_id` string: ID do usuário que concluiu a tarefa.
    - `deal_id` string: ID da negociação associada.
    - `owner_ids` string[]: IDs dos usuários responsáveis pela tarefa.
    - `created_at` string, date-time: Data de criação da tarefa.
    - `updated_at` string, date-time: Data de atualização da tarefa.

## Response `200`

OK

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Assunto da tarefa.
    - `description` string: Notas ou descrição adicional da tarefa.
    - `type` 'call' | 'email' | 'meeting' | 'task' | 'lunch' | 'visit' | 'whatsapp': Tipo da tarefa.
    - `status` 'open' | 'completed' | 'canceled': Status da tarefa.
    - `due_date` string, date-time: Data limite para conclusão da tarefa.
    - `created_by_id` string: ID do usuário que criou a tarefa.
    - `completed_at` string, date-time: Data em que a tarefa foi concluída.
    - `completed_by_id` string: ID do usuário que concluiu a tarefa.
    - `deal_id` string: ID da negociação associada.
    - `owner_ids` string[]: IDs dos usuários responsáveis pela tarefa.
    - `created_at` string, date-time: Data de criação da tarefa.
    - `updated_at` string, date-time: Data de atualização da tarefa.

## Other responses

- `400`: A requisição está malformada e não consegue ser processada.
- `401`: O token da API está ausente ou inválido.
- `403`: O token não tem permissão para acessar o recurso solicitado.
- `404`: O recurso solicitado não existe.
- `422`: A entidade não pode ser processada.
- `429`: O limite de requisições foi excedido.
- `500`: Erro interno ou inesperado no servidor.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)