/exchanges

List all conversation exchanges with an Agent

GET /v1 /exchanges

This endpoint returns a paginated list of exchange IDs associated with a specific Agent. Each exchange represents a session. Which is a multi-turn interaction thread between a user and the Agent.

Header

Key	Value
Authorization	YOUR_API_KEY

Parameters

Key	Type	Description
agent_id	String	Target Agent ID
page_number	Integer	Default is 1

Request

import requests

url = "https://api.zams.com/v1/exchanges"

headers = {
    "Authorization": "ApiKey <your_api_key>",
    "Content-Type": "application/json"
}

payload = {
    "agent_id": "c7uuh82",
    "page_number": 1
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Response

200

A response with the names and IDs of exchanges.

{
    "Fast way to Schedule": "x7a2k93q",
    "Question on Books": "c7uuh82"
}

400

{
    "error": "Unauthorized"
}