---
title: "PUT /tasks/{task_id}"
method: PUT
path: "/tasks/{task_id}"
tags: ["tasks"]
---

# PUT /tasks/{task_id}

`PUT /tasks/{task_id}`

Update a task or activity by ID.

## Path parameters

- `task_id` integer, required

## Request body

- PutTasks — Update a task or activity by ID.
  - `text` string — Text content of this task.
  - `assigned_users` integer[] — Array of IDs of users assigned to this task.
  - `due_date` string, date-time — When this task is due.
  - `finished_date` string, date-time — When this task was finished. Send null together with finished_by to unfinish it.
  - `finished_by` integer — ID of user who finished this task. Send null together with finished_date to unfinish it.
  - `type` 'VISITA' | 'REUNIAO' | 'LIGACAO' | 'EMAIL' | 'PROPOSTA' | 'WHATSAPP' — Task type.
  - `metrics` integer[] — Array of metric IDs to associate with this task.

## Response `200`

OK

- object
  - `task_entity` TaskEntity
    - `id` integer — Task ID.
    - `accountId` integer — Account ID.
    - `user` object — User that created this task.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `text` string — Text content.
    - `organization` object — Related organization.
      - `id` string — Organization ID.
      - `name` string — Display name (Nome fantasia).
      - `email` string — Contact email.
    - `person` object — Related person.
      - `id` integer — Person ID.
      - `name` string — Person name.
      - `email` string, email — Email address.
    - `deal` object — Related deal.
      - `id` string
      - `title` string
    - `dueDate` unknown
    - `finishedAt` unknown
    - `finishedBy` object — User who finished this task.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `createdAt` unknown
    - `updatedAt` unknown
    - `assignedUsers` LeanUserEntity[] — Users assigned to this task
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `metrics` ActivityMetricEntity[] — Metrics associated with this task.
      - `id` integer — Metric ID.
      - `name` string — Metric name.
      - `value` number — Metric value.
    - `type` string — Task type.
    - `_webUrl` string — Web platform URL.
    - `audioTranscription` object — VoIP transcription. Included when available and includeVoip=true.
      - `id` integer — Audio transcription ID.
      - `content` string — Audio transcription content. May be null.
      - `liked` boolean — Whether the user liked the transcription. Null when no rating was provided.
      - `feedback` string — User feedback. May be null.
    - `audioSummary` object — VoIP summary. Present only with includeVoip=true and when available.
      - `id` integer — Audio summary ID.
      - `content` string — Audio summary content. May be null.
      - `liked` boolean — Whether the user liked the summary. Null when no rating was provided.
      - `feedback` string — User feedback. May be null.
      - `audioTranscriptionId` integer — ID of the transcription used to produce this summary.

## Changes

- **2026-09-22** `3af6904194dc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agendor/apis/agendor-api/changes/tasks/:task_id/put.md)

---

[API](https://skmtc.dev/agendor/apis/agendor-api.md) · [All operations](https://skmtc.dev/agendor/apis/agendor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agendor/apis/agendor-api/revisions/913425271171?raw)