accounts

Update

POST
Updates an account's information.

Request

This endpoint expects an object.
id
stringRequired
The ID of account to update.
artifacts
objectOptional
custom_fields
map from strings to anyOptional
Application-defined custom fields.
description
stringOptional
Updated description of the account.
display_name
stringOptional
Updated display name for the account.
domains
list of stringsOptional
Updated list of company's domain names. Example - ['devrev.ai'].
external_refs
list of stringsOptional
Updated External Refs of account.
owned_by
list of stringsOptional
Updated list of the users owning this account.
schema_fragment_ids
list of stringsOptional
Schema fragment IDs associated with this account SOR.
tags
list of objectsOptional
Updated tags list associated with the account.
tier
stringOptional
Updated tier of the account.

Response

This endpoint returns an object
account
object
POST
1curl -X POST https://api.devrev.ai/accounts.update \
2 -H "Authorization: <apiKey>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "id": "ACC-12345"
6}'
200
Successful
1{
2 "account": {
3 "external_refs": [
4 "external_refs"
5 ],
6 "id": "id",
7 "owned_by": [],
8 "artifacts": [
9 {
10 "id": "id"
11 }
12 ],
13 "created_date": "2023-01-01T12:00:00Z",
14 "custom_fields": {
15 "custom_fields": {
16 "key": "value"
17 }
18 },
19 "custom_schema_fragments": [
20 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
21 ],
22 "description": "description",
23 "display_id": "display_id",
24 "display_name": "display_name",
25 "domains": [
26 "domains"
27 ],
28 "modified_date": "2023-01-01T12:00:00Z",
29 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
30 "subtype": "subtype",
31 "tags": [
32 {
33 "tag": {
34 "id": "id",
35 "name": "name"
36 }
37 }
38 ],
39 "tier": "tier"
40 }
41}