---
title: "TextMessageConversations.update"
method: PATCH
path: "/entities/TextMessageConversations/{id}"
tags: ["Text Message"]
---

# TextMessageConversations.update

`PATCH /entities/TextMessageConversations/{id}`

## Request

- Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id`
- URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/TextMessageConversations/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/coevera/apis/coevera-crm-api/docs/entities/TextMessageConversations/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Changes fields of the TextMessageConversation record with the given id; fields left out keep their values.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateTextMessageConversationInput: Field values to change on a TextMessageConversation record; fields left out keep their values.
  - `phone_id` string, uuid: Id of the sender phone.
  - `recipient_account_id` string, uuid: Id of the matched account.
  - `recipient_contact_id` string, uuid: Id of the matched contact.
  - `recipient_phone_number` string: External phone number of the conversation recipient. Cannot be changed once the conversation has started.
  - `revision` integer: Revision when entity was lastly changed.
  - `messages` object[]: Messages exchanged in the conversation, ordered by send time.
    - `id` string, uuid: Id of the related TextMessage record.
  - `account_relations` object[]: Accounts linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.
  - `contact_relations` object[]: Contacts linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.
  - `project_relations` object[]: Projects linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.
  - `lead_relations` object[]: Leads linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.
  - `opportunity_relations` object[]: Opportunities linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.
  - `quote_relations` object[]: Quotes linked to this conversation.
    - `id` string, uuid: Id of the related TextMessageConversationRelations record.

## Response `200`

The changed TextMessageConversation record.

- object
  - `success` boolean: True when the request succeeded; false on error.
  - `data` TextMessageConversation: Text message conversation between a Coevera phone number and an external phone number.
    - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
    - `id` string, uuid, required: Unique identifier of entity.
    - `is_deleted` boolean: Specifies if the entity is considered deleted.
    - `modified` string, date-time: Last modification time.
    - `created` string, date-time: Creation time.
    - `phone` string, uri, required: Coevera phone number used as the sender side of the conversation. Related Phone record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Phone' for its fields.
    - `recipient_account` string, uri: Account record matched to the recipient phone, when one exists. Related Account record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Account' for its fields.
    - `recipient_contact` string, uri: Contact record matched to the recipient phone, when one exists. Related Contact record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Contact' for its fields.
    - `phone_id` string, uuid, required: Id of the sender phone.
    - `recipient_account_id` string, uuid: Id of the matched account.
    - `recipient_contact_id` string, uuid: Id of the matched contact.
    - `recipient_phone_number` string: External phone number of the conversation recipient. Cannot be changed once the conversation has started.
    - `revision` integer: Revision when entity was lastly changed.
    - `messages` string[]: Messages exchanged in the conversation, ordered by send time.
    - `account_relations` string[]: Accounts linked to this conversation.
    - `contact_relations` string[]: Contacts linked to this conversation.
    - `project_relations` string[]: Projects linked to this conversation.
    - `lead_relations` string[]: Leads linked to this conversation.
    - `opportunity_relations` string[]: Opportunities linked to this conversation.
    - `quote_relations` string[]: Quotes linked to this conversation.

## Other responses

- `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`.
- `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED).
- `404`: No such record or entity (code 143 ERROR_NO_ENTITY, or 2006 ERROR_UNKNOWN_TYPE).
- `422`: Validation failed (code 40000, with the failing fields) or a required parameter is missing (code 119). By default one failed item fails a whole batch and nothing is written.
- `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry.
- `500`: Unexpected server error (code 1000, ERROR_UNKNOWN).

---

[API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)