Update Thread Share

Update the active share for a thread (owner only).

Strict-update: fails with 404 if no active share exists for the thread —
use POST to create one. Updates access_level, expiry_date,
public_can_write, and the invitee list (delta-synced internally — SpiceDB
writes only happen for users whose state actually changed). Does NOT modify
snapshot_created_at or the share's owner; use the snapshot/refresh endpoint
to advance the snapshot explicitly.

Path Parameters:

thread_id (int): The ID of the chat thread.

Request Body:

access_level (str): Optional. "PUBLIC" or "INVITE_ONLY". Only changed if provided.

expiry_date (str): Optional. ISO 8601 datetime for share expiration.

user_permissions (dict): Optional. Dict of email -> permissions. Required when
setting access_level to INVITE_ONLY.

public_can_write (bool): Optional. For PUBLIC shares: allow write/fork access.

Request Headers:

X-Authorization-Consistency-Token (string, optional): Authorization consistency
token for read-after-write consistency. Pass the token received from a previous
write operation so the manage-permission check sees the latest state.

Returns:

A response containing the updated share in data.

Response Headers:

X-Authorization-Consistency-Token (string): SpiceDB consistency token from the
write. Echo it back on subsequent reads for read-after-write consistency.

Current Version:

2.0.0

curl --location --globoff --request PUT 'https:///api/v2/chat-threads//shares' \ --header 'Ocp-Apim-Subscription-Key: ' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "access_level": "PUBLIC", "expiry_date": "2027-01-01T00:00:00Z", "user_permissions": {}, "public_can_write": true }'

{ "success": true, "message": "Share updated successfully", "data": { "id": 123, "share_token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "access_level": "PUBLIC", "status": "ACTIVE", "expiry_date": "2027-01-01T00:00:00Z", "consent_given": true, "snapshot_created_at": "2026-01-06T12:30:00Z", "agent": 5, "chat_thread": 42, "is_expired": false, "is_accessible": true, "public_can_write": true, "user": 1, "created_by": "[email protected]", "modified_by": "[email protected]", "created_on": "2026-01-06T12:30:00Z", "modified_on": "2027-01-06T09:15:00Z", "invite_results": [] } }

Request

Responses