Update (Beta) — DevRev

Updates an account’s information.

Request

This endpoint expects an object.

idstringRequired

The ID of account to update.

artifactsobjectOptional

custom_fieldsmap from strings to anyOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Requested custom schemas described abstractly. Every provided schema’s custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

descriptionstringOptional

Updated description of the account.

display_namestringOptional

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.

tierstringOptional

Updated tier of the account.

schema_fragment_idslist of stringsOptionalDeprecated

Schema fragment IDs associated with this account SOR.

Response

This endpoint returns an 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": "ACC-12345" 6 }'

1 { 2 "account": { 3 "external_refs": [ 4 "external_refs" 5 ], 6 "id": "id", 7 "owned_by": [ 8 { 9 "type": "sys_user", 10 "id": "owned_by" 11 } 12 ], 13 "artifacts": [ 14 { 15 "id": "id" 16 } 17 ], 18 "created_by": { 19 "type": "sys_user", 20 "id": "created_by", 21 "display_id": "created_by", 22 "display_name": "created_by", 23 "display_picture": { 24 "id": "id" 25 }, 26 "email": "created_by", 27 "full_name": "created_by", 28 "state": "active" 29 }, 30 "created_date": "2023-01-01T12:00:00Z", 31 "custom_fields": { 32 "key": "value" 33 }, 34 "custom_schema_fragments": [ 35 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 36 ], 37 "description": "description", 38 "display_id": "display_id", 39 "display_name": "display_name", 40 "domains": [ 41 "domains" 42 ], 43 "modified_by": { 44 "type": "sys_user", 45 "id": "modified_by", 46 "display_id": "modified_by", 47 "display_name": "modified_by", 48 "display_picture": { 49 "id": "id" 50 }, 51 "email": "modified_by", 52 "full_name": "modified_by", 53 "state": "active" 54 }, 55 "modified_date": "2023-01-01T12:00:00Z", 56 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 57 "subtype": "subtype", 58 "tags": [ 59 { 60 "tag": { 61 "id": "id", 62 "name": "name" 63 } 64 } 65 ], 66 "tier": "tier" 67 } 68 }

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	"external_refs": [
4	"external_refs"
5	],
6	"id": "id",
7	"owned_by": [
8	{
9	"type": "sys_user",
10	"id": "owned_by"
11	}
12	],
13	"artifacts": [
14	{
15	"id": "id"
16	}
17	],
18	"created_by": {
19	"type": "sys_user",
20	"id": "created_by",
21	"display_id": "created_by",
22	"display_name": "created_by",
23	"display_picture": {
24	"id": "id"
25	},
26	"email": "created_by",
27	"full_name": "created_by",
28	"state": "active"
29	},
30	"created_date": "2023-01-01T12:00:00Z",
31	"custom_fields": {
32	"key": "value"
33	},
34	"custom_schema_fragments": [
35	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
36	],
37	"description": "description",
38	"display_id": "display_id",
39	"display_name": "display_name",
40	"domains": [
41	"domains"
42	],
43	"modified_by": {
44	"type": "sys_user",
45	"id": "modified_by",
46	"display_id": "modified_by",
47	"display_name": "modified_by",
48	"display_picture": {
49	"id": "id"
50	},
51	"email": "modified_by",
52	"full_name": "modified_by",
53	"state": "active"
54	},
55	"modified_date": "2023-01-01T12:00:00Z",
56	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
57	"subtype": "subtype",
58	"tags": [
59	{
60	"tag": {
61	"id": "id",
62	"name": "name"
63	}
64	}
65	],
66	"tier": "tier"
67	}
68	}