View Thread Share

GET

/api/v2/chat-threads/share/{share_token}

Access shared thread content with permission validation (recipient-facing).

Returns thread content as it existed at the time of share creation
(snapshot behavior). Validates permissions based on share status (must
be ACTIVE), share expiry date, access level (PUBLIC or INVITE_ONLY), and
user permissions (for INVITE_ONLY shares). All access is logged for
audit purposes.

Path Parameters:

share_token (str): The share's unique UUID token, returned in the share_token
field of the share object when it was created, updated, or listed. Clients build
the recipient-facing share URL from this value (the server does not return a
ready-made URL).

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 to ensure this read reflects that write.

Returns:

A response containing thread data and the recipient's permissions in data.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

🟠410

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///api/v2/chat-threads/share/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - View Share Response

{
    "success": true,
    "message": "Thread retrieved successfully",
    "data": {
        "thread_id": 42,
        "title": "AI Discussion Thread",
        "agent_id": 5,
        "messages": [
            {
                "question": "What is AI?",
                "response": {
                    "answer": "AI stands for Artificial Intelligence...",
                    "citations": []
                },
                "query_source": "web",
                "is_deleted": false,
                "created_on": "2026-01-06T10:00:00Z",
                "modified_on": "2026-01-06T10:00:00Z",
                "created_by": "[email protected]",
                "modified_by": "[email protected]"
            },
            {
                "question": "Tell me about machine learning",
                "response": {
                    "answer": "Machine learning is a subset of AI...",
                    "citations": []
                },
                "query_source": "web",
                "is_deleted": false,
                "created_on": "2026-01-06T10:05:00Z",
                "modified_on": "2026-01-06T10:05:00Z",
                "created_by": "[email protected]",
                "modified_by": "[email protected]"
            }
        ],
        "documents": [
            {
                "type": "file",
                "source": "product-spec.pdf",
                "normalized_source": "product-spec.pdf",
                "description": "Product specification document",
                "tags": [
                    "spec",
                    "product"
                ],
                "step": "completed",
                "is_failed": false,
                "is_deleted": false,
                "created_on": "2026-01-05T09:00:00Z",
                "modified_on": "2026-01-05T09:00:00Z",
                "created_by": "[email protected]",
                "modified_by": "[email protected]"
            }
        ],
        "share_info": {
            "access_level": "INVITE_ONLY",
            "created_at": "2026-01-06T12:00:00Z",
            "expires_at": "2026-12-31T23:59:59Z"
        },
        "permissions": {
            "can_view": true,
            "can_write": true,
            "is_owner": false
        }
    }
}

Refresh Thread Share Snapshot

Get Thread Share Access Log