Get or create thread

get

Retrieve or create a thread for a customer on a specific channel and get its messages in multimodal format.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The ID of the agent.

customerIdstringRequired

The ID of the customer.

channelstringRequired

The channel name. Supported channels are: facebook, instagram, whatsapp, tiktok, or any channel starting with 'chatbot.' (e.g., 'chatbot.web', 'chatbot.mobile'). Note: For channels starting with 'chatbot.', the customer must have a widget_chatbot.id field.

Example: {"value":"facebook","summary":"Facebook channel"}

Query parameters

limitintegerOptional

Optional limit for the number of messages to return (starting from the last message). If not provided, returns all messages.

Responses

200

Successful Response

application/json

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/agents/{agentId}/customers/{customerId}/threads/{channel}

HTTPcURLJavaScriptPython

GET /v1/agents/{agentId}/customers/{customerId}/threads/{channel} HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "agentId": "text",
  "customerId": "text",
  "from": {
    "channel": "text",
    "id": "text"
  },
  "status": "text",
  "aiResponseStatus": "text",
  "createdAt": "2025-12-09T23:08:44.581Z",
  "updatedAt": "2025-12-09T23:08:44.581Z",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "text"
        }
      ]
    }
  ]
}