SparrowDesk
ConversationsId

Update a conversation

PATCH
/conversations/{id}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idinteger

Conversation id

Request Body

subject?string
priority?string
status?string
assignee?string
Formatemail
team?string
custom_fields?

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://app.sparrowdesk.com/v1/conversations/0" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": 12345,
    "brand": "Support Brand",
    "brand_id": 12345,
    "source": "Mail",
    "status": "Open",
    "priority": "High",
    "created_at": 1672531200,
    "first_response_time": 1672534800,
    "resolution_time": null,
    "due": 1672617600,
    "first_response_due": 1672538400,
    "requested_by_email": "[email protected]",
    "requested_by_id": 67890,
    "assigned_to_member_id": 123,
    "assigned_to_team_id": 456,
    "last_updated_at": 1672535400,
    "subject": "Payment issue with order #12345",
    "description_html": "<p>I'm having trouble with my payment...</p>",
    "description_text": "I'm having trouble with my payment...",
    "tags": [
      {
        "id": 1,
        "label": "billing"
      }
    ],
    "custom_fields": [
      {
        "id": 9250,
        "value": "ORD-12345"
      }
    ],
    "properties": {
      "request_language": "English",
      "browser_timezone": "Asia/Calcutta",
      "browser": "Chrome",
      "device": "mac OS 10.15.7",
      "ip_address": "192.168.1.1",
      "country": "India",
      "region": "Tamil Nadu > Chennai",
      "referral_url": "http://localhost:9091/",
      "utm_source": "",
      "utm_medium": "",
      "utm_campaign": "",
      "utm_content": "",
      "utm_term": ""
    }
  }
}
{
  "error": {
    "message": "Invalid field values"
  }
}
{
  "error": {
    "message": "Conversation not found"
  }
}
{
  "error": {
    "message": "Error updating conversation"
  }
}