Update contact
curl --request PATCH \
--url http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"metadata": {}
}
'import requests
url = "http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id}"
payload = {
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phoneNumber: '<string>', name: '<string>', email: '<string>', metadata: {}})
};
fetch('http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Contact Lists
Update contact
Modify phone number, name, email, or metadata of a contact
PATCH
/
contact-lists
/
{listId}
/
contacts
/
{id}
Update contact
curl --request PATCH \
--url http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"metadata": {}
}
'import requests
url = "http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id}"
payload = {
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phoneNumber: '<string>', name: '<string>', email: '<string>', metadata: {}})
};
fetch('http://localhost:8787/api/v1/contact-lists/{listId}/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Updates an existing contact record in a contact list.
Path parameters
string
required
The unique UUID of the contact list.
string
required
The unique UUID of the contact to update.
Body parameters
string
Updated E.164 phone number.
string
Updated contact name.
string
Updated contact email address.
object
Updated arbitrary metadata object.
curl -X PATCH https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts/99999999-8888-7777-6666-555555555555 \
-H "Authorization: Bearer $AGENTIC_OS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Asha Patel (VP Sales)",
"metadata": {
"plan": "Enterprise",
"priority": "high"
}
}'
import requests
response = requests.patch(
"https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts/99999999-8888-7777-6666-555555555555",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"name": "Asha Patel (VP Sales)",
"metadata": {"plan": "Enterprise", "priority": "high"},
},
)
print(response.json())
const response = await fetch(
"https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts/99999999-8888-7777-6666-555555555555",
{
method: "PATCH",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Asha Patel (VP Sales)",
metadata: { plan: "Enterprise", priority: "high" },
}),
},
);
const data = await response.json();
console.log(data);
Response
{
"id": "99999999-8888-7777-6666-555555555555",
"tenantId": "990e8400-e29b-41d4-a716-446655440000",
"contactListId": "33333333-3333-3333-3333-333333333333",
"phoneNumber": "+919876543210",
"name": "Asha Patel (VP Sales)",
"email": "asha.patel@example.com",
"metadata": {
"plan": "Enterprise",
"priority": "high"
},
"createdAt": "2026-06-01T09:10:00.000Z",
"updatedAt": "2026-06-01T09:25:00.000Z"
}
⌘I