Update Conversation Metadata & Attributes

Atomically updates or deletes custom metadata keys on the conversation thread and contact record.

PATCH/api/v1/inbox/conversations/{id}/metadata

Body Parameters

1 parameter

{id}uuidrequired

Conversation UUID

application/json

metadataobjectoptional

Key-value pairs to set or update in conversation metadata

contact_attributesobjectoptional

Key-value pairs to update on the linked contact record

delete_keysstring[]optional

Array of conversation metadata keys to remove

200 OKapplication/json

successbooleanrequired

Whether update succeeded

data.conversation_iduuidrequired

Conversation UUID

data.conversation_metadataobjectrequired

Updated conversation metadata

data.contact_attributesobjectrequired

Updated contact attributes

data.updated_atdatetimerequired

Update timestamp in IST (+05:30)

1	curl -X PATCH "https://app.chatofy.in/api/v1/inbox/conversations/conv-8888-9999-aaaa-bbbbccccdddd/metadata" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"metadata":{"order_id":"ORD-98421","support_tier":"priority"},"contact_attributes":{"vip_tier":"Platinum"}}'

Was this endpoint guide helpful?

1	curl -X PATCH "https://app.chatofy.in/api/v1/inbox/conversations/conv-8888-9999-aaaa-bbbbccccdddd/metadata" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"metadata":{"order_id":"ORD-98421","support_tier":"priority"},"contact_attributes":{"vip_tier":"Platinum"}}'

200 OKapplication/json

1	{
2	"success": true,
3	"data": {
4	"conversation_id": "conv-8888-9999-aaaa-bbbbccccdddd",
5	"contact_id": "cnt-1111-2222-3333-444455556666",
6	"conversation_metadata": {
7	"order_id": "ORD-98421",
8	"support_tier": "priority"
9	},
10	"contact_attributes": {
11	"vip_tier": "Platinum"
12	},
13	"updated_at": "2026-10-27T10:00:00+05:30"
14	},
15	"message": "Conversation metadata updated successfully"
16	}

Code Snippets & Examples

1	curl -X PATCH "https://app.chatofy.in/api/v1/inbox/conversations/conv-8888-9999-aaaa-bbbbccccdddd/metadata" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"metadata":{"order_id":"ORD-98421","support_tier":"priority"},"contact_attributes":{"vip_tier":"Platinum"}}'