---
title: "Update Call"
method: PATCH
path: "/Call/{id}"
tags: ["Call"]
---

# Update Call

`PATCH /Call/{id}`

Update an existing 'Call' record.

## Request body

- Call
  - `id` string — An ID.
  - `name` string — A one-line string.
  - `status` 'Planned' | 'Held' | 'Not Held'
  - `dateStart` string — A timestamp in UTC.
  - `dateEnd` string — A timestamp in UTC.
  - `direction` 'Outbound' | 'Inbound'
  - `description` string, nullable — A multi-line text.
  - `parentId` string, nullable — A foreign record ID.
  - `parentType` 'Account' | 'Lead' | 'Contact' | 'Opportunity' | 'Case' | 'CCompany', nullable — An entity type.
  - `parentName` string, nullable — A foreign record name.
  - `accountId` string, nullable — An ID of the record of the Account type.
  - `accountName` string, nullable — A foreign record name.
  - `uid` string, nullable — A one-line string.
  - `acceptanceStatus` 'None' | 'Accepted' | 'Tentative' | 'Declined'
  - `usersIds` string[], nullable — IDs of records of the User type.
  - `usersNames` object, nullable — An {ID => record name} map.
  - `usersColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `contactsIds` string[], nullable — IDs of records of the Contact type.
  - `contactsNames` object, nullable — An {ID => record name} map.
  - `contactsColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `leadsIds` string[], nullable — IDs of records of the Lead type.
  - `leadsNames` object, nullable — An {ID => record name} map.
  - `leadsColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `createdAt` string, nullable — A timestamp in UTC.
  - `modifiedAt` string, nullable — A timestamp in UTC.
  - `createdById` string, nullable — An ID of the record of the User type.
  - `createdByName` string, nullable — A foreign record name.
  - `modifiedById` string, nullable — An ID of the record of the User type.
  - `modifiedByName` string, nullable — A foreign record name.
  - `assignedUserId` string — An ID of the record of the User type.
  - `assignedUserName` string, nullable — A foreign record name.
  - `teamsIds` string[], nullable — IDs of records of the Team type.
  - `teamsNames` object, nullable — An {ID => record name} map.

## Response `200`

Success.

- Call
  - `id` string — An ID.
  - `name` string — A one-line string.
  - `status` 'Planned' | 'Held' | 'Not Held'
  - `dateStart` string — A timestamp in UTC.
  - `dateEnd` string — A timestamp in UTC.
  - `direction` 'Outbound' | 'Inbound'
  - `description` string, nullable — A multi-line text.
  - `parentId` string, nullable — A foreign record ID.
  - `parentType` 'Account' | 'Lead' | 'Contact' | 'Opportunity' | 'Case' | 'CCompany', nullable — An entity type.
  - `parentName` string, nullable — A foreign record name.
  - `accountId` string, nullable — An ID of the record of the Account type.
  - `accountName` string, nullable — A foreign record name.
  - `uid` string, nullable — A one-line string.
  - `acceptanceStatus` 'None' | 'Accepted' | 'Tentative' | 'Declined'
  - `usersIds` string[], nullable — IDs of records of the User type.
  - `usersNames` object, nullable — An {ID => record name} map.
  - `usersColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `contactsIds` string[], nullable — IDs of records of the Contact type.
  - `contactsNames` object, nullable — An {ID => record name} map.
  - `contactsColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `leadsIds` string[], nullable — IDs of records of the Lead type.
  - `leadsNames` object, nullable — An {ID => record name} map.
  - `leadsColumns` object, nullable — An {ID => object} map. Relationship column values.
  - `createdAt` string, nullable — A timestamp in UTC.
  - `modifiedAt` string, nullable — A timestamp in UTC.
  - `createdById` string, nullable — An ID of the record of the User type.
  - `createdByName` string, nullable — A foreign record name.
  - `modifiedById` string, nullable — An ID of the record of the User type.
  - `modifiedByName` string, nullable — A foreign record name.
  - `assignedUserId` string — An ID of the record of the User type.
  - `assignedUserName` string, nullable — A foreign record name.
  - `teamsIds` string[], nullable — IDs of records of the Team type.
  - `teamsNames` object, nullable — An {ID => record name} map.

## Other responses

- `400` — Bad request. Might be a validation error. Check logs for details.
- `403` — Forbidden. Might be an access control error. Check logs for details.
- `409` — Conflict.

---

[API](https://skmtc.net/espocrm/apis/espocrm-api.md) · [All operations](https://skmtc.net/espocrm/apis/espocrm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/espocrm/espocrm-api/versions/6622dabfccd3/schema)