Skip to main content
PATCH
/
api
/
replies
/
{id}
Update Reply
curl --request PATCH \
  --url https://api.example.com/api/replies/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "category_id": "<string>",
  "status": "<string>",
  "ai_response": "<string>"
}
'
{
  "data": {}
}
Update properties of an existing reply, such as changing its category or modifying the draft response.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the reply

​
Request Body

​
category_id
string
Update the reply’s category by providing a category UUID
​
status
string
Update the reply status. Options: pending, ready, archived
To set status to sent, use the Send Reply endpoint instead.
​
ai_response
string
Update or set the draft response content

​
Response

​
data
object
The updated reply object (same structure as Get Reply)

​
Examples

​
Change Category

curl -X PATCH "https://app.replyify.ai/api/replies/abc123-def456-ghi789" \
  -H "Authorization: Bearer rpl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"category_id": "cat-interested-456"}'

​
Archive a Reply

curl -X PATCH "https://app.replyify.ai/api/replies/abc123-def456-ghi789" \
  -H "Authorization: Bearer rpl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "archived"}'

​
Update Draft Response

curl -X PATCH "https://app.replyify.ai/api/replies/abc123-def456-ghi789" \
  -H "Authorization: Bearer rpl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"ai_response": "Hi John,\n\nCustomized response here...\n\nBest regards"}'

​
Response Example

{
  "data": {
    "id": "abc123-def456-ghi789",
    "from_email": "[email protected]",
    "from_name": "John Smith",
    "status": "archived",
    "category_id": "cat-interested-456",
    "ai_response": "Hi John,\n\nCustomized response here...\n\nBest regards",
    "updated_at": "2024-01-15T16:00:00Z"
  }
}

​
Errors

​
400 Bad Request
{
  "error": "Invalid category_id"
}
The provided category ID doesn’t exist in your workspace.
​
404 Not Found
{
  "error": "Reply not found"
}
The specified reply ID doesn’t exist in your workspace.