---
title: "Update Contact"
method: PATCH
path: "/v1/agents/{agent_id}/contacts/{contact_id}"
tags: ["Contacts"]
---

# Update Contact

`PATCH /v1/agents/{agent_id}/contacts/{contact_id}`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/agents/{agent_id}/contacts/{contact_id}`
- Auth: HTTP bearer

Update a contact's name, label or phone number.

Only include the fields you want to change; the old values are
overwritten. Send label as null or "" to clear it. Changing phone_number
to one another contact of this agent already has returns HTTP 409 with
that contact_id.

Returns the updated contact (id, agent_id, name, label, phone_number,
created_at, updated_at).

## Path parameters

- `agent_id` string, required: ID (agt_...) of the agent whose contact list to use, from create_agent or list_agents.
- `contact_id` string, required: Contact ID (con_...) from create_contact or list_contacts.

## Request body

- ContactUpdate
  - `name` string, nullable: Replacement name for the contact, e.g. 'Dr. Patel'. Omit to keep the current name.
  - `phone_number` string, nullable: Replacement phone number with a leading + and country code, e.g. '+12125551234'; formatting characters are removed. Omit to keep the current number.
  - `label` string, nullable: Replacement purpose or relationship, e.g. 'dentist'. Send null or an empty string to remove the label; omit to keep it.

## Response `200`

Successful Response

- ContactOut
  - `id` string, required: Unique contact identifier (e.g. 'con_abc123')
  - `agent_id` string, required: Agent whose contact list this entry belongs to
  - `name` string, required: Contact name
  - `label` string, nullable: Purpose or relationship
  - `phone_number` string, required: Phone number in E.164 format
  - `created_at` string, date-time, required: When the contact was saved
  - `updated_at` string, date-time, required: When the contact was last changed

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)