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

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": "id" 6 }'

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

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": "id"
6	}'

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