Get Thread Share Settings
GET
/api/v2/chat-threads/{thread_id}/shares/settings
(access level, expiry, public_can_write, etc.),
new_messages_count(messages added to the thread after
snapshot_created_at — show the"Refresh Snapshot" button when > 0), and active invited users with their
permissions (INVITE_ONLY shares only).
/access-log for those.token for read-after-write consistency. Pass the token received from a previous
write (e.g. right after updating invitees) so both the manage check and the
SpiceDB-sourced invitee list reflect the latest state.
data.Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https:///api/v2/chat-threads//shares/settings' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer 'Response Response Example
200 - Settings Response
{
"success": true,
"message": "Share settings retrieved successfully",
"data": {
"share": {
"id": 123,
"share_token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"access_level": "INVITE_ONLY",
"public_can_write": false,
"status": "ACTIVE",
"expiry_date": "2026-12-31T23:59:59Z",
"consent_given": true,
"created_at": "2026-01-06T12:30:00Z",
"new_messages_count": 3,
"pii_redaction": false,
"thread_id": 42,
"thread_title": "AI Discussion Thread"
},
"invited_users": [
{
"email": "[email protected]",
"user_id": 2,
"username": "alice",
"permissions": {
"can_view": true,
"can_write": true
},
"invited_at": "2026-01-06T12:00:00Z"
},
{
"email": "[email protected]",
"user_id": 3,
"username": "bob",
"permissions": {
"can_view": true,
"can_write": false
},
"invited_at": "2026-01-06T12:05:00Z"
}
]
}
}