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

# TagRelations.update

`PATCH /entities/TagRelations/{id}`

Modifies TagRelation or TagRelations with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateTagRelationInput
  - `account_id` string, uuid — Id of the linked account.
  - `appointment_id` string, uuid — Id of the linked appointment.
  - `contact_id` string, uuid — Id of the linked contact.
  - `custom_entity_id` string, uuid — Id of the linked custom entity record.
  - `email_id` string, uuid — Id of the linked email.
  - `lead_id` string, uuid — Id of the linked lead.
  - `oppty_id` string, uuid — Id of the linked opportunity.
  - `process_id` string, uuid — Id of the linked sales process.
  - `project_id` string, uuid — Id of the linked project.
  - `quote_id` string, uuid — Id of the linked quote.
  - `tag_id` string, uuid — Id of the tag.
  - `task_id` string, uuid — Id of the linked task.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting TagRelation

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` TagRelation
    - `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.
    - `account` string, uri — Account the tag is attached to, or empty when not attached to an account. 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.
    - `appointment` string, uri — Appointment the tag is attached to, or empty when not attached to an appointment. Relation to Appointment. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Appointment' object for properties.
    - `contact` string, uri — Contact the tag is attached to, or empty when not attached to a contact. 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.
    - `custom_entity` string, uri — Custom entity record the tag is attached to, or empty when not attached to a custom entity record. Relation to CustomEntity. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CustomEntity' object for properties.
    - `email` string, uri — Email the tag is attached to, or empty when not attached to an email. Relation to Email. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Email' object for properties.
    - `lead` string, uri — Lead the tag is attached to, or empty when not attached to a lead. Relation to Lead. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Lead' object for properties.
    - `oppty` string, uri — Opportunity the tag is attached to, or empty when not attached to an opportunity. Relation to Opportunity. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Opportunity' object for properties.
    - `process` string, uri — Sales process the tag is attached to, or empty when not attached to a process. Relation to Process. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Process' object for properties.
    - `project` string, uri — Project the tag is attached to, or empty when not attached to a project. Relation to Project. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Project' object for properties.
    - `quote` string, uri — Quote the tag is attached to, or empty when not attached to a quote. Relation to Quote. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Quote' object for properties.
    - `tag` string, uri, required — Tag being attached to the record. Relation to Tag. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Tag' object for properties.
    - `task` string, uri — Task the tag is attached to, or empty when not attached to a task. Relation to Task. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Task' object for properties.
    - `account_id` string, uuid — Id of the linked account.
    - `appointment_id` string, uuid — Id of the linked appointment.
    - `contact_id` string, uuid — Id of the linked contact.
    - `custom_entity_id` string, uuid — Id of the linked custom entity record.
    - `email_id` string, uuid — Id of the linked email.
    - `lead_id` string, uuid — Id of the linked lead.
    - `oppty_id` string, uuid — Id of the linked opportunity.
    - `process_id` string, uuid — Id of the linked sales process.
    - `project_id` string, uuid — Id of the linked project.
    - `quote_id` string, uuid — Id of the linked quote.
    - `tag_id` string, uuid, required — Id of the tag.
    - `task_id` string, uuid — Id of the linked task.
    - `revision` integer — Revision when entity was lastly changed.

## Other responses

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

---

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