# Update contact information

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

## 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/contacts/{id}

**Update contact information**

Update contact details and optionally update their shared documents

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

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | Contact ID |

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

- `title` (string): Job title of the contact
- `review_status` (enum: to_review | in_review | approved | rejected): Updated review status
- `first_name` (string): Updated first name
- `last_name` (string): Updated last name
- `email` (string (email)): Updated email address
- `documents` (array of string): Array of document IDs to share with the contact

Example (Update contact information):

```json
{
  "first_name": "John",
  "last_name": "Doe",
  "title": "Senior Security Manager",
  "review_status": "approved"
}
```

Example (Approve contact):

```json
{
  "review_status": "approved"
}
```

Example (Update contact and share documents):

```json
{
  "first_name": "Jane",
  "last_name": "Smith",
  "review_status": "approved",
  "documents": [
    "550e8400-e29b-41d4-a716-446655440000",
    "550e8400-e29b-41d4-a716-446655440001"
  ]
}
```

**Responses:**

- `200` - Contact updated successfully
  - `ok` (boolean)
- `400` - Bad Request - validation failed
- `401` - Unauthorized
- `404` - Not Found - Contact not found
- `405` - Method not allowed
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X PATCH "https://app.orbiqhq.com/api/v1/contacts/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Security Manager",
    "review_status": "approved",
    "documents": ["doc-id-1", "doc-id-2"]
  }'

```