Update Account (Beta) — DevRev

Updates an account’s information.

Request

This endpoint expects an object.

artifactsobjectRequired

custom_schema_specobjectRequired

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.

idstringRequiredformat: "id"

The ID of account to update.

websitesobjectRequired

custom_fieldsobjectOptional

Application-defined custom fields.

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.

schema_fragment_idslist of stringsOptionalDeprecated

Schema fragment IDs associated with this account SOR.

Response

Updated account object.

accountobject

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

1 { 2 "account": { 3 "created_by": { 4 "type": "dev_user", 5 "display_picture": { 6 "file": { 7 "type": "type", 8 "name": "name" 9 }, 10 "id": "id", 11 "display_id": "display_id" 12 }, 13 "id": "id", 14 "state": "active", 15 "display_id": "display_id", 16 "display_name": "display_name", 17 "email": "email", 18 "full_name": "full_name" 19 }, 20 "id": "id", 21 "modified_by": { 22 "type": "dev_user", 23 "display_picture": { 24 "file": { 25 "type": "type", 26 "name": "name" 27 }, 28 "id": "id", 29 "display_id": "display_id" 30 }, 31 "id": "id", 32 "state": "active", 33 "display_id": "display_id", 34 "display_name": "display_name", 35 "email": "email", 36 "full_name": "full_name" 37 }, 38 "owned_by": [ 39 { 40 "type": "dev_user", 41 "display_picture": { 42 "file": { 43 "type": "type", 44 "name": "name" 45 }, 46 "id": "id", 47 "display_id": "display_id" 48 }, 49 "id": "id", 50 "state": "active", 51 "display_id": "display_id", 52 "display_name": "display_name", 53 "email": "email", 54 "full_name": "full_name" 55 }, 56 { 57 "type": "dev_user", 58 "display_picture": { 59 "file": { 60 "type": "type", 61 "name": "name" 62 }, 63 "id": "id", 64 "display_id": "display_id" 65 }, 66 "id": "id", 67 "state": "active", 68 "display_id": "display_id", 69 "display_name": "display_name", 70 "email": "email", 71 "full_name": "full_name" 72 } 73 ], 74 "artifacts": [ 75 { 76 "file": { 77 "type": "type", 78 "name": "name" 79 }, 80 "id": "id", 81 "display_id": "display_id" 82 }, 83 { 84 "file": { 85 "type": "type", 86 "name": "name" 87 }, 88 "id": "id", 89 "display_id": "display_id" 90 } 91 ], 92 "created_date": "created_date", 93 "custom_fields": {}, 94 "custom_schema_fragments": [ 95 "custom_schema_fragments", 96 "custom_schema_fragments" 97 ], 98 "description": "description", 99 "display_id": "display_id", 100 "display_name": "display_name", 101 "domains": [ 102 "domains", 103 "domains" 104 ], 105 "external_refs": [ 106 "external_refs", 107 "external_refs" 108 ], 109 "modified_date": "modified_date", 110 "stock_schema_fragment": "stock_schema_fragment", 111 "subtype": "subtype", 112 "tags": [ 113 { 114 "tag": { 115 "id": "id", 116 "name": "name", 117 "style_new": { 118 "color": "color" 119 }, 120 "display_id": "display_id" 121 }, 122 "value": "value" 123 }, 124 { 125 "tag": { 126 "id": "id", 127 "name": "name", 128 "style_new": { 129 "color": "color" 130 }, 131 "display_id": "display_id" 132 }, 133 "value": "value" 134 } 135 ], 136 "tier": "tier", 137 "websites": [ 138 "websites", 139 "websites" 140 ] 141 } 142 }

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

1	{
2	"account": {
3	"created_by": {
4	"type": "dev_user",
5	"display_picture": {
6	"file": {
7	"type": "type",
8	"name": "name"
9	},
10	"id": "id",
11	"display_id": "display_id"
12	},
13	"id": "id",
14	"state": "active",
15	"display_id": "display_id",
16	"display_name": "display_name",
17	"email": "email",
18	"full_name": "full_name"
19	},
20	"id": "id",
21	"modified_by": {
22	"type": "dev_user",
23	"display_picture": {
24	"file": {
25	"type": "type",
26	"name": "name"
27	},
28	"id": "id",
29	"display_id": "display_id"
30	},
31	"id": "id",
32	"state": "active",
33	"display_id": "display_id",
34	"display_name": "display_name",
35	"email": "email",
36	"full_name": "full_name"
37	},
38	"owned_by": [
39	{
40	"type": "dev_user",
41	"display_picture": {
42	"file": {
43	"type": "type",
44	"name": "name"
45	},
46	"id": "id",
47	"display_id": "display_id"
48	},
49	"id": "id",
50	"state": "active",
51	"display_id": "display_id",
52	"display_name": "display_name",
53	"email": "email",
54	"full_name": "full_name"
55	},
56	{
57	"type": "dev_user",
58	"display_picture": {
59	"file": {
60	"type": "type",
61	"name": "name"
62	},
63	"id": "id",
64	"display_id": "display_id"
65	},
66	"id": "id",
67	"state": "active",
68	"display_id": "display_id",
69	"display_name": "display_name",
70	"email": "email",
71	"full_name": "full_name"
72	}
73	],
74	"artifacts": [
75	{
76	"file": {
77	"type": "type",
78	"name": "name"
79	},
80	"id": "id",
81	"display_id": "display_id"
82	},
83	{
84	"file": {
85	"type": "type",
86	"name": "name"
87	},
88	"id": "id",
89	"display_id": "display_id"
90	}
91	],
92	"created_date": "created_date",
93	"custom_fields": {},
94	"custom_schema_fragments": [
95	"custom_schema_fragments",
96	"custom_schema_fragments"
97	],
98	"description": "description",
99	"display_id": "display_id",
100	"display_name": "display_name",
101	"domains": [
102	"domains",
103	"domains"
104	],
105	"external_refs": [
106	"external_refs",
107	"external_refs"
108	],
109	"modified_date": "modified_date",
110	"stock_schema_fragment": "stock_schema_fragment",
111	"subtype": "subtype",
112	"tags": [
113	{
114	"tag": {
115	"id": "id",
116	"name": "name",
117	"style_new": {
118	"color": "color"
119	},
120	"display_id": "display_id"
121	},
122	"value": "value"
123	},
124	{
125	"tag": {
126	"id": "id",
127	"name": "name",
128	"style_new": {
129	"color": "color"
130	},
131	"display_id": "display_id"
132	},
133	"value": "value"
134	}
135	],
136	"tier": "tier",
137	"websites": [
138	"websites",
139	"websites"
140	]
141	}
142	}