Overview
PingBack provides three status-transition endpoints for conversations:- Resolve — marks a conversation as resolved and records the
resolved_attimestamp. - Close — marks a conversation as closed and records the
closed_attimestamp. - Assign — reassigns a conversation to a different agent.
PUT operations so you can model your support workflow precisely.
Resolve a conversation
Sets the conversation’sstatus to "resolved" and records resolved_at.
Method: PUT
URL: /api/v1/conversations/{conversation_id}/resolve
Headers
| Header | Value |
|---|---|
| Authorization | Bearer |
Path parameters
The UUID of the conversation to resolve.
Response
Timestamp when the conversation was resolved.
If the conversation is already resolved, the endpoint returns
{"detail": "Already resolved"} with a 200 status.Example
Response example
Close a conversation
Sets the conversation’sstatus to "closed" and records closed_at.
Method: PUT
URL: /api/v1/conversations/{conversation_id}/close
Headers
| Header | Value |
|---|---|
| Authorization | Bearer |
Path parameters
The UUID of the conversation to close.
Response
Timestamp when the conversation was closed.
If the conversation is already closed, the endpoint returns
{"detail": "Already closed"} with a 200 status.Example
Response example
Assign a conversation
Reassigns a conversation to a different agent. Method:PUT
URL: /api/v1/conversations/{conversation_id}/assign/{agent_id}
Headers
| Header | Value |
|---|---|
| Authorization | Bearer |
Path parameters
The UUID of the conversation to reassign.
The ID of the agent to assign the conversation to.
Response
The ID of the newly assigned agent.
Example
Response example
Errors
| Status | Meaning |
|---|---|
| 401 | Unauthorized — missing or invalid Bearer token |
| 404 | Conversation not found |