PATCH https://chatloka.net/api/v1/conversations/{conversation}

Update Conversation

Update conversation status, assignee, labels, or custom attributes.

Required scope: conversations:write

How to Use This Endpoint

1. Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

2. Get Your Conversation ID

Use the List Conversations endpoint to find the conversation ID. The response includes data.id which is the conversation ID you need.

Body Parameters

Field	Type	Required	Description
`status`	`string`	Optional	open \| pending \| resolved \| closed
`assigned_user_id`	`integer`	Optional	User ID to assign (null to unassign)
`assigned_team_id`	`integer`	Optional	Team ID to assign
`labels`	`array`	Optional	Array of label IDs
`custom_attributes`	`object`	Optional	Map of custom attribute key => value

Request Body

application/json

{
  "status": "resolved",
  "assigned_user_id": 5
}

Example Request

bash

curl -X PATCH 'https://chatloka.net/api/v1/conversations/{conversation}' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "resolved",
  "assigned_user_id": 5
}'

Response

200 OK

application/json

{
  "success": true,
  "data": {
    "id": 123,
    "status": "resolved",
    "contact": {
      "id": "9b1c8f20-...",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "john@example.com"
    },
    "channel": {
      "id": 1,
      "name": "WhatsApp",
      "plugin": "whatsapp_cloud"
    },
    "assigned_user": {
      "id": 5,
      "name": "Jane Smith"
    },
    "assigned_team": null,
    "labels": [],
    "custom_attributes": {},
    "unread_count": 0,
    "last_message_at": "2026-07-14T10:30:00+00:00",
    "last_message_preview": "Thanks for your order!",
    "created_at": "2026-07-10T08:00:00+00:00",
    "updated_at": "2026-07-14T10:35:00+00:00"
  }
}

Error Responses

401 UNAUTHORIZED

{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Invalid or revoked API key" } }

403 FORBIDDEN

{ "success": false, "error": { "code": "FORBIDDEN", "message": "You do not have permission to access this resource." } }

404 NOT_FOUND

{ "success": false, "error": { "code": "NOT_FOUND", "message": "The requested resource was not found." } }

422 VALIDATION_ERROR

{ "success": false, "error": { "code": "VALIDATION_ERROR", "message": "The given data was invalid.", "details": { "field": ["The field is required."] } } }

429 RATE_LIMIT_EXCEEDED

{ "success": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Too many requests. Please slow down.", "retry_after": 60 } }

Back to Conversations

Send Message Resolve Conversation

Stop Losing Customers
to Slow Responses

Every minute you wait is revenue walking out the door. Join hundreds of businesses who transformed their customer communication with ChatOn.

50%

Faster Response

24/7

AI Support

40%

Higher Conversion

No credit card required

Setup in 5 minutes

Cancel anytime

✓ 30-day money-back guarantee

Update Conversation

How to Use This Endpoint

Body Parameters

Request Body

Example Request

Response

Error Responses

Stop Losing Customers
to Slow Responses

🍪 We use cookies

Cookie Preferences

Update Conversation

How to Use This Endpoint

Body Parameters

Request Body

Example Request

Response

Error Responses

Stop Losing Customers to Slow Responses

🍪 We use cookies

Cookie Preferences

Stop Losing Customers
to Slow Responses