List Thread Shares
GET
/api/v2/chat-threads/{thread_id}/shares
Only the thread owner can access this endpoint.
data.items[] — every share the thread has ever had.Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https:///api/v2/chat-threads//shares' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer 'Response Response Example
200 - List Response
{
"success": true,
"message": "Retrieved 2 share(s)",
"data": {
"items": [
{
"id": 123,
"share_token": "public-token-abc123",
"access_level": "PUBLIC",
"status": "ACTIVE",
"expiry_date": "2026-12-31T23:59:59Z",
"consent_given": true,
"snapshot_created_at": "2026-01-06T10:00:00Z",
"agent": 5,
"chat_thread": 42,
"is_expired": false,
"is_accessible": true,
"user": 1,
"created_by": "[email protected]",
"modified_by": "[email protected]",
"created_on": "2026-01-06T10:00:00Z",
"modified_on": "2026-01-06T10:00:00Z"
},
{
"id": 124,
"share_token": "invite-token-def456",
"access_level": "INVITE_ONLY",
"status": "ACTIVE",
"expiry_date": "2026-01-15T23:59:59Z",
"consent_given": true,
"snapshot_created_at": "2026-01-06T11:30:00Z",
"agent": 5,
"chat_thread": 42,
"is_expired": false,
"is_accessible": true,
"user": 1,
"created_by": "[email protected]",
"modified_by": "[email protected]",
"created_on": "2026-01-06T11:30:00Z",
"modified_on": "2026-01-06T11:30:00Z"
}
]
}
}