Update Account (Beta) — DevRev

Updates an account’s information.

Request

This endpoint expects an object.

idstringRequiredformat: "id"

The ID of account to update.

artifactsobjectOptional

custom_fieldsobjectOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Custom schemas described using identifiers. Each custom field in the request must have the corresponding schema specified; omission results in a Bad Request error. If a custom schema is not included in the specifier, it remains unchanged. For surfaces with human interactors, it is recommended to provide tenant_fragment: true and validate_required_fields: true.

descriptionstringOptionalformat: "text"

Updated description of the account.

display_namestringOptionalformat: "text"

Updated display name for the account.

domainslist of stringsOptional

Updated list of company’s domain names. Example - [‘devrev.ai’].

external_refslist of stringsOptional

Updated External Refs of account.

owned_bylist of stringsOptional

Updated list of the users owning this account.

tagslist of objectsOptional

Updated tags list associated with the account.

tierstringOptionalformat: "text"

Updated tier of the account.

websitesobjectOptional

schema_fragment_idslist of stringsOptionalDeprecated

Schema fragment IDs associated with this account SOR.

Response

Updated account object.

accountobject

Errors

1 curl -X POST https://api.devrev.ai/accounts.update \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "id": "ACC-12345" 6 }'

1 { 2 "account": { 3 "id": "foo", 4 "owned_by": [ 5 { 6 "display_id": "foo", 7 "id": "foo", 8 "display_name": "foo", 9 "display_picture": { 10 "display_id": "foo", 11 "id": "foo", 12 "file": { 13 "type": "foo", 14 "name": "foo", 15 "size": 42 16 } 17 }, 18 "email": "foo", 19 "full_name": "foo", 20 "state": "active" 21 } 22 ], 23 "artifacts": [ 24 { 25 "id": "foo", 26 "display_id": "foo", 27 "file": { 28 "type": "foo", 29 "name": "foo", 30 "size": 42 31 } 32 } 33 ], 34 "created_by": { 35 "display_id": "foo", 36 "id": "foo", 37 "display_name": "foo", 38 "display_picture": { 39 "display_id": "foo", 40 "id": "foo", 41 "file": { 42 "type": "foo", 43 "name": "foo", 44 "size": 42 45 } 46 }, 47 "email": "foo", 48 "full_name": "foo", 49 "state": "active" 50 }, 51 "created_date": "2023-01-01T12:00:00.000Z", 52 "custom_fields": {}, 53 "custom_schema_fragments": [ 54 "foo" 55 ], 56 "description": "foo", 57 "display_id": "foo", 58 "display_name": "foo", 59 "domains": [ 60 "foo" 61 ], 62 "external_refs": [ 63 "foo" 64 ], 65 "modified_by": { 66 "display_id": "foo", 67 "id": "foo", 68 "display_name": "foo", 69 "display_picture": { 70 "display_id": "foo", 71 "id": "foo", 72 "file": { 73 "type": "foo", 74 "name": "foo", 75 "size": 42 76 } 77 }, 78 "email": "foo", 79 "full_name": "foo", 80 "state": "active" 81 }, 82 "modified_date": "2023-01-01T12:00:00.000Z", 83 "primary_account": { 84 "id": "foo", 85 "display_id": "foo", 86 "display_name": "foo" 87 }, 88 "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id", 89 "subtype": "foo", 90 "tags": [ 91 { 92 "tag": { 93 "id": "foo", 94 "name": "foo", 95 "display_id": "foo", 96 "style_new": { 97 "color": "foo" 98 } 99 }, 100 "value": "foo" 101 } 102 ], 103 "tier": "foo", 104 "websites": [ 105 "foo" 106 ] 107 } 108 }

1	curl -X POST https://api.devrev.ai/accounts.update \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"id": "ACC-12345"
6	}'

1	{
2	"account": {
3	"id": "foo",
4	"owned_by": [
5	{
6	"display_id": "foo",
7	"id": "foo",
8	"display_name": "foo",
9	"display_picture": {
10	"display_id": "foo",
11	"id": "foo",
12	"file": {
13	"type": "foo",
14	"name": "foo",
15	"size": 42
16	}
17	},
18	"email": "foo",
19	"full_name": "foo",
20	"state": "active"
21	}
22	],
23	"artifacts": [
24	{
25	"id": "foo",
26	"display_id": "foo",
27	"file": {
28	"type": "foo",
29	"name": "foo",
30	"size": 42
31	}
32	}
33	],
34	"created_by": {
35	"display_id": "foo",
36	"id": "foo",
37	"display_name": "foo",
38	"display_picture": {
39	"display_id": "foo",
40	"id": "foo",
41	"file": {
42	"type": "foo",
43	"name": "foo",
44	"size": 42
45	}
46	},
47	"email": "foo",
48	"full_name": "foo",
49	"state": "active"
50	},
51	"created_date": "2023-01-01T12:00:00.000Z",
52	"custom_fields": {},
53	"custom_schema_fragments": [
54	"foo"
55	],
56	"description": "foo",
57	"display_id": "foo",
58	"display_name": "foo",
59	"domains": [
60	"foo"
61	],
62	"external_refs": [
63	"foo"
64	],
65	"modified_by": {
66	"display_id": "foo",
67	"id": "foo",
68	"display_name": "foo",
69	"display_picture": {
70	"display_id": "foo",
71	"id": "foo",
72	"file": {
73	"type": "foo",
74	"name": "foo",
75	"size": 42
76	}
77	},
78	"email": "foo",
79	"full_name": "foo",
80	"state": "active"
81	},
82	"modified_date": "2023-01-01T12:00:00.000Z",
83	"primary_account": {
84	"id": "foo",
85	"display_id": "foo",
86	"display_name": "foo"
87	},
88	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
89	"subtype": "foo",
90	"tags": [
91	{
92	"tag": {
93	"id": "foo",
94	"name": "foo",
95	"display_id": "foo",
96	"style_new": {
97	"color": "foo"
98	}
99	},
100	"value": "foo"
101	}
102	],
103	"tier": "foo",
104	"websites": [
105	"foo"
106	]
107	}
108	}