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

# TextMessageConversations.update

`PATCH /entities/TextMessageConversations/{id}`

Modifies TextMessageConversation or TextMessageConversations with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateTextMessageConversationInput
  - `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, uri
  - `account_relations` object[] — Accounts linked to this conversation.
    - `id` string, uri
  - `contact_relations` object[] — Contacts linked to this conversation.
    - `id` string, uri
  - `project_relations` object[] — Projects linked to this conversation.
    - `id` string, uri
  - `lead_relations` object[] — Leads linked to this conversation.
    - `id` string, uri
  - `opportunity_relations` object[] — Opportunities linked to this conversation.
    - `id` string, uri
  - `quote_relations` object[] — Quotes linked to this conversation.
    - `id` string, uri

## Response `200`

Modification confirmation. Returns resulting TextMessageConversation

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` TextMessageConversation
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `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. Relation to Phone. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Phone' object for properties.
    - `recipient_account` string, uri — Account record matched to the recipient phone, when one exists. Relation to Account. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Account' object for properties.
    - `recipient_contact` string, uri — Contact record matched to the recipient phone, when one exists. Relation to Contact. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Contact' object for properties.
    - `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

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

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