# Update account

URL: /en/docs/api/v1/accounts/id/patch
Last Updated: 2026-07-30T21:15:44.990Z

## Description
No description available.

## Available Actions
- Execute PATCH request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### PATCH /api/v1/accounts/{id}

**Update account**

Update account information, contacts, and associated documents. Supports adding, updating, and removing contacts.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | Yes | Account ID |

**Request body** (`application/json`) - required:

- `title` (string): Account name
- `description` (string): Account description
- `review_status` (enum: to_review | in_review | approved | cancelled): Review status
- `sfdc_account_id` (string): Salesforce ID
- `domain` (string): Primary domain
- `logo` (string): Logo ID
- `access_expiry_datetime` (string (date-time)): Access expiry
- `nda` (boolean): NDA requirement
- `type` (enum: standard | enterprise): Account type
- `internal_notes` (string): Internal notes
- `auto_approval` (boolean): Whether to automatically approve access requests from this account's domain
- `documents` (array of string): Document IDs to associate
- `contacts_add` (array of object): Contacts to add
  - `first_name` (string, required)
  - `last_name` (string)
  - `email` (string (email), required)
  - `title` (string)
- `contacts_update` (array of object): Contacts to update
  - `id` (string, required)
  - `first_name` (string)
  - `last_name` (string)
  - `email` (string (email))
  - `title` (string)
- `contacts_remove` (array of string): Contact IDs to remove

Example (Update basic account information):

```json
{
  "title": "Updated Company Name",
  "description": "Updated description",
  "review_status": "approved"
}
```

Example (Add new contacts to account):

```json
{
  "contacts_add": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "title": "Security Manager"
    }
  ]
}
```

Example (Update existing and remove contacts):

```json
{
  "title": "Burger King EU",
  "contacts_update": [
    {
      "id": "contact-123",
      "title": "Senior Compliance Manager"
    }
  ],
  "contacts_remove": [
    "contact-456"
  ]
}
```

Example (Comprehensive account update):

```json
{
  "title": "Acme Corporation",
  "description": "Enterprise customer - updated 2025",
  "review_status": "approved",
  "type": "enterprise",
  "auto_approval": true,
  "domain": "acme.com",
  "internal_notes": "VIP customer - expedite requests",
  "contacts_add": [
    {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@acme.com",
      "title": "CISO"
    }
  ]
}
```

**Responses:**

- `200` - Account updated successfully
  - `success` (boolean)
  - `data` (object)
    - `ok` (boolean)
- `400` - Bad Request - validation failed or no data provided
  - `error` (string): Validation error message
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Account not found
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X PATCH "https://app.orbiqhq.com/api/v1/accounts/{id}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```