PATCH
/
api
/
v1
/
contacts
/
{id}
curl -X PATCH https://api.ravan.ai/api/v1/contacts/019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"company": "Acme Corp Inc."}'

{
  "success": true, "message": "Contact updated successfully",
  "data": { "id": "019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b", "first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp Inc.", "updated_at": "2026-03-20T16:00:00Z" }
}
This is a partial update (PATCH). Only include the fields you want to modify.

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key.

​
Path Parameters

​
id
string
required
UUID of the contact to update.

​
Body

​
first_name
string
Updated first name.
​
last_name
string
Updated last name.
​
email
string
Updated email.
​
phone
string
Updated phone (E.164).
​
company
string
Updated company.
​
metadata
object
Updated metadata.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
The updated contact record.
curl -X PATCH https://api.ravan.ai/api/v1/contacts/019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"company": "Acme Corp Inc."}'

{
  "success": true, "message": "Contact updated successfully",
  "data": { "id": "019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b", "first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp Inc.", "updated_at": "2026-03-20T16:00:00Z" }
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
string
required

Contact ID

Body

application/json
​
first_name
string
​
last_name
string
​
email
string
​
phone
string
​
company
string
​
metadata
object

Response

Successful response

​
success
boolean
​
message
string
​
data
object