Update contact list
curl --request PATCH \
--url http://localhost:8787/api/v1/contact-lists/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"metadata": {}
}
'import requests
url = "http://localhost:8787/api/v1/contact-lists/{id}"
payload = {
"name": "<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({name: '<string>', metadata: {}})
};
fetch('http://localhost:8787/api/v1/contact-lists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Contact Lists
Update contact list
Update contact list name or metadata
PATCH
/
contact-lists
/
{id}
Update contact list
curl --request PATCH \
--url http://localhost:8787/api/v1/contact-lists/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"metadata": {}
}
'import requests
url = "http://localhost:8787/api/v1/contact-lists/{id}"
payload = {
"name": "<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({name: '<string>', metadata: {}})
};
fetch('http://localhost:8787/api/v1/contact-lists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Updates an existing contact list.
Path parameters
string
required
The unique UUID of the contact list to update.
Body parameters
string
New name for the contact list (must remain unique across tenant).
object
Updated arbitrary key-value metadata.
curl -X PATCH https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333 \
-H "Authorization: Bearer $AGENTIC_OS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Q3 Target Leads — Qualified"
}'
import requests
response = requests.patch(
"https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"name": "Q3 Target Leads — Qualified"},
)
print(response.json())
const response = await fetch(
"https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333",
{
method: "PATCH",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ name: "Q3 Target Leads — Qualified" }),
},
);
const data = await response.json();
console.log(data);
Response
{
"id": "33333333-3333-3333-3333-333333333333",
"tenantId": "990e8400-e29b-41d4-a716-446655440000",
"name": "Q3 Target Leads — Qualified",
"metadata": {
"source": "hubspot_export"
},
"createdAt": "2026-06-01T09:00:00.000Z",
"updatedAt": "2026-06-01T09:30:00.000Z"
}
⌘I