Update Account

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 }

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

Headers

Request

Response

Errors