---
title: "Atualizar histórico de ligação"
method: PUT
path: "/calls/{call_id}"
---

# Atualizar histórico de ligação

`PUT /calls/{call_id}`

## Request

- Base URL: `https://api.pipe.run/v1`
- URL: `https://api.pipe.run/v1/calls/{call_id}`
- Auth: API key in header `token`
- TypeScript: <https://skmtc.dev/pipe/apis/application-json/docs/calls/:call_id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `call_id` integer, required

## Headers

- `Content-Type` string, required
- `Token` string, required

## Request body

- object
  - `account_id` integer: ID da conta do PipeRun.
  - `user_id` integer: ID do usuário do PipeRun.
  - `from_user_id` integer: ID do usuário de origem da ligação.
  - `deal_id` integer: ID da oportunidade atrelada à ligação.
  - `company_id` integer: ID da empresa atrelada à ligação.
  - `person_id` integer: ID da pessoa atrelada à ligação.
  - `username` string: Nome do usuário do webphone responsável pela ligação.
  - `from_number` string: Número de origem da ligação.
  - `to_number` string: Número de destino da ligação.
  - `record_audio` boolean: Gravar o áudio da chamada: false: não gravar, true: gravar.
  - `from_caller_id` integer: ID do identificador de chamadas de origem da ligação.
  - `to_caller_id` integer: ID do identificador de chamadas de destino da ligação.
  - `description` string: Descrição da ligação.
  - `start_at` string, date: Horário de início da ligação. Formatos aceitos: AAAA-MM-DD, AAAA-MM-DD HH:MM:SS.
  - `end_at` string, date: Horário de término da ligação: Formatos aceitos: AAAA-MM-DD, AAAA-MM-DD HH:MM:SS.
  - `record_url` string: URL apontando para a gravação da chamada.
  - `external_call_id` integer: ID de ligação externa.
  - `important` boolean: Define o histórico de ligação como importante: false: não importante, true: importante.
  - `duration` integer: Duração da chamada.
  - `cost` string: Custo da chamada.

## Response `201`

201

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` integer
    - `account_id` integer
    - `user_id` integer
    - `from_user_id` integer
    - `deal_id` integer
    - `company_id` integer
    - `person_id` integer
    - `webphone_id` integer
    - `webphone_extension_id` integer
    - `name` string
    - `from_number` string
    - `to_number` string
    - `record_audio` integer
    - `from_caller_id` string
    - `to_caller_id` string
    - `description` string
    - `start_at` string
    - `end_at` string
    - `status` integer
    - `record_url` string
    - `external_call_id` integer
    - `json_return` string
    - `important` integer
    - `duration` string
    - `cost` number
    - `created_at` string
    - `updated_at` string

## Other responses

- `400`: 400
- `422`: 422

## Changes

- **2026-11-03** `cdfaac104426`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pipe/apis/application-json/changes/calls/:call_id/put.md)

---

[API](https://skmtc.dev/pipe/apis/application-json.md) - [All operations](https://skmtc.dev/pipe/apis/application-json/llms.txt) - [OpenAPI document](https://skmtc.dev/pipe/apis/application-json/revisions/cdfaac104426?raw)