Update

POST

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.

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.

schema_fragment_idslist of stringsOptional

Schema fragment IDs associated with this account SOR.

tagslist of objectsOptional

Updated tags list associated with the account.

tierstringOptional

Updated tier of the account.

Response

This endpoint returns an object.

accountobject

POST

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 }'

200Successful

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       "key": "value"
16     },
17     "custom_schema_fragments": [
18       "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
19     ],
20     "description": "description",
21     "display_id": "display_id",
22     "display_name": "display_name",
23     "domains": [
24       "domains"
25     ],
26     "modified_date": "2023-01-01T12:00:00Z",
27     "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
28     "subtype": "subtype",
29     "tags": [
30       {
31         "tag": {
32           "id": "id",
33           "name": "name"
34         }
35       }
36     ],
37     "tier": "tier"
38   }
39 }

Built with

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	"artifacts": [
9	{
10	"id": "id"
11	}
12	],
13	"created_date": "2023-01-01T12:00:00Z",
14	"custom_fields": {
15	"key": "value"
16	},
17	"custom_schema_fragments": [
18	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
19	],
20	"description": "description",
21	"display_id": "display_id",
22	"display_name": "display_name",
23	"domains": [
24	"domains"
25	],
26	"modified_date": "2023-01-01T12:00:00Z",
27	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
28	"subtype": "subtype",
29	"tags": [
30	{
31	"tag": {
32	"id": "id",
33	"name": "name"
34	}
35	}
36	],
37	"tier": "tier"
38	}
39	}