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

# Accounts.update

`PATCH /entities/Accounts/{id}`

Modifies Account or Accounts with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateAccountInput
  - `created` string, date-time — Creation time.
  - `picture` object — Profile picture or company logo associated with the account. Relation to CloudObject, see: 'updateCloudObjectInput' object for properties.
    - `id` string, uri
  - `account_class` 1 | 2 | 3 | 4 | 5 — Manual classification grade assigned to the account. Used in segmentation and reporting. Integer enum value: 1 - NoClass, 2 - ClassA, 3 - ClassB, 4 - ClassC, 5 - ClassD
  - `account_type_id` string, uuid — Id of the account type assigned to this account.
  - `address` string — Street address of the account.
  - `city` string — City of the account address.
  - `comments` string — Free-form notes describing the account.
  - `country` string — Country of the account address.
  - `currency_exchange_rates_list_id` string, uuid — Id of the currency exchange rate list applied to this account.
  - `customer_type_id` string, uuid — Id of the customer type.
  - `email1` string — Primary email address of the account. Used as default recipient for emails sent from Coevera.
  - `email2` string — Additional email address.
  - `email3` string — Additional email address.
  - `email4` string — Additional email address.
  - `email5` string — Additional email address.
  - `home_page` string — Website URL of the account. May be auto-filled from the primary email domain when domain extraction is enabled.
  - `industry_id` string, uuid — Id of the industry classification.
  - `is_archived` boolean — True when the account has been archived. Archived accounts remain readable but are hidden from active lists and cannot be edited until reactivated.
  - `last_ai_account_hierarchy_applied` string, date-time — Time when an AI-suggested account hierarchy was last applied to this account.
  - `last_ai_org_chart_applied` string, date-time — Time when an AI-suggested org chart was last applied to this account.
  - `name` string — Name of the entity and its default text representation.
  - `owner_id` string, uuid — Id of the account owner.
  - `parent_account_id` string, uuid — Id of the parent account.
  - `parent_account_relation_type_id` string, uuid — Id of the parent-account relationship type.
  - `phone1` string — Primary phone number of the account. Used as default target for click-to-call.
  - `phone2` string — Additional phone number.
  - `phone3` string — Additional phone number.
  - `phone4` string — Additional phone number.
  - `phone5` string — Additional phone number.
  - `picture_id` string, uuid — Id of the profile picture document.
  - `quick_parent_account_name` string — Free-text parent-account name used when the parent has not been linked to an actual Account record. Lets integrators note the relationship without creating a separate parent Account.
  - `share_mode` 0 | 1 | 2 | 3 — Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users). The matching sharing_units / sharing_clients lists control who is granted access. Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit
  - `state_province` string — State or province of the account address.
  - `unit_id` string, uuid — Id of the sales unit.
  - `zip_code` string — ZIP or postal code of the account address.
  - `revision` integer — Revision when entity was lastly changed.
  - `social_media` object — Social network profiles linked to this account (e.g. LinkedIn, Facebook). Relation to AccountSocialRelation, see: 'updateAccountSocialRelationInput' object for properties.
    - `id` string, uri
  - `sharing_units` object[] — Sales units that have been granted shared access to this account. Editable only when share_mode allows unit sharing.
    - `id` string, uri
  - `sharing_clients` object[] — Users that have been granted shared access to this account. Editable only when share_mode allows user sharing.
    - `id` string, uri
  - `documents` object[] — Documents linked to this account.
    - `id` string, uri
  - `is_unsubscribed` boolean — If account has any unsubscribed email.
  - `tags` object[] — Tag labels applied to this account.
    - `id` string, uri
  - `static_profiles` object[] — Saved view profiles this account currently matches.
    - `id` string, uri

## Response `200`

Modification confirmation. Returns resulting Account

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` Account
    - `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_type` string, uri, required — Account type that classifies this account. Account types are configurable per team space and drive which form, fields and pipelines apply. Relation to AccountType. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'AccountType' object for properties.
    - `currency_exchange_rates_list` string, uri — Currency exchange rate list used to convert monetary fields linked to this account. Empty to inherit the team space default. Relation to CurrencyExchangeRatesList. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CurrencyExchangeRatesList' object for properties.
    - `customer_type` string, uri — Customer category (e.g. Lead, Prospect, Customer). Configurable per team space. Relation to Data. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Data' object for properties.
    - `industry` string, uri — Industry the account operates in. Configurable per team space. Relation to Data. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Data' object for properties.
    - `owner` string, uri, required — Sales user who owns this account. Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties.
    - `parent_account` string, uri — Parent account in a corporate hierarchy. Empty for top-level accounts. 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.
    - `parent_account_relation_type` string, uri — Type of relationship to the parent account (e.g. subsidiary, branch). Required when parent_account is set. Relation to ParentAccountRelationType. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'ParentAccountRelationType' object for properties.
    - `picture` string, uri — Profile picture or company logo associated with the account. Relation to CloudObject. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CloudObject' object for properties.
    - `unit` string, uri, required — Sales unit this account is assigned to. Determines which team members can see the record under unit-based sharing. Relation to SalesUnit. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'SalesUnit' object for properties.
    - `account_class` 1 | 2 | 3 | 4 | 5 — Manual classification grade assigned to the account. Used in segmentation and reporting. Integer enum value: 1 - NoClass, 2 - ClassA, 3 - ClassB, 4 - ClassC, 5 - ClassD
    - `account_type_id` string, uuid — Id of the account type assigned to this account.
    - `address` string — Street address of the account.
    - `city` string — City of the account address.
    - `comments` string — Free-form notes describing the account.
    - `country` string — Country of the account address.
    - `currency_exchange_rates_list_id` string, uuid — Id of the currency exchange rate list applied to this account.
    - `customer_type_id` string, uuid — Id of the customer type.
    - `email1` string — Primary email address of the account. Used as default recipient for emails sent from Coevera.
    - `email2` string — Additional email address.
    - `email3` string — Additional email address.
    - `email4` string — Additional email address.
    - `email5` string — Additional email address.
    - `health_category` string, uuid — Coarser bucket of health_status used for grouping and reporting. Read-only.
    - `health_status` integer — Computed entity-health state (e.g. healthy, at-risk). Read-only; recalculated by Coevera when relevant fields change.
    - `home_page` string — Website URL of the account. May be auto-filled from the primary email domain when domain extraction is enabled.
    - `industry_id` string, uuid — Id of the industry classification.
    - `is_archived` boolean — True when the account has been archived. Archived accounts remain readable but are hidden from active lists and cannot be edited until reactivated.
    - `last_ai_account_hierarchy_applied` string, date-time — Time when an AI-suggested account hierarchy was last applied to this account.
    - `last_ai_org_chart_applied` string, date-time — Time when an AI-suggested org chart was last applied to this account.
    - `name` string, required — Name of the entity and its default text representation.
    - `owner_id` string, uuid, required — Id of the account owner.
    - `parent_account_id` string, uuid — Id of the parent account.
    - `parent_account_relation_type_id` string, uuid — Id of the parent-account relationship type.
    - `phone1` string — Primary phone number of the account. Used as default target for click-to-call.
    - `phone2` string — Additional phone number.
    - `phone3` string — Additional phone number.
    - `phone4` string — Additional phone number.
    - `phone5` string — Additional phone number.
    - `picture_id` string, uuid — Id of the profile picture document.
    - `quick_parent_account_name` string — Free-text parent-account name used when the parent has not been linked to an actual Account record. Lets integrators note the relationship without creating a separate parent Account.
    - `share_mode` 0 | 1 | 2 | 3 — Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users). The matching sharing_units / sharing_clients lists control who is granted access. Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit
    - `state_province` string — State or province of the account address.
    - `unit_id` string, uuid — Id of the sales unit.
    - `zip_code` string — ZIP or postal code of the account address.
    - `revision` integer — Revision when entity was lastly changed.
    - `formatted_name` string, required — Display version of the account name, used in lists and references.
    - `social_media` string, uri — Social network profiles linked to this account (e.g. LinkedIn, Facebook). Relation to AccountSocialRelation. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'AccountSocialRelation' object for properties.
    - `sharing_units` string[] — Sales units that have been granted shared access to this account. Editable only when share_mode allows unit sharing.
    - `sharing_clients` string[] — Users that have been granted shared access to this account. Editable only when share_mode allows user sharing.
    - `documents` string[] — Documents linked to this account.
    - `is_favorite` boolean, required — True when the current authenticated user has marked this account as favorite. Per-user.
    - `is_unsubscribed` boolean — If account has any unsubscribed email.
    - `tags` string[] — Tag labels applied to this account.
    - `static_profiles` string[] — Saved view profiles this account currently matches.
    - `health` object — Composite entity-health summary, combining current and previous state with last-calculation metadata. Read-only; computed by Coevera.
    - `modified_by_user` string, date-time — Timestamp of the most recent modification made by an end user (excluding system changes). Read-only; computed by Coevera.

## 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)