Skip to main content
GET
/
chats
/
{id}
Get Chat
curl --request GET \
  --url https://app.splox.io/api/v1/chats/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resource_id": "<string>",
  "is_public": true,
  "public_share_token": "<string>",
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Retrieves a chat session by ID. Users can only access their own chats.

​
Usage

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.splox.io/api/v1/chats/{chat_id}

​
Response

{
  "id": "0199f200-a11b-7c8d-4444-888890abcdef",
  "name": "Customer Support Chat",
  "user_id": "0199d001-c45d-9e0f-3456-789012cdef01",
  "resource_type": "api",
  "resource_id": "0199e001-a23b-7c8d-1234-567890abcdef",
  "is_public": false,
  "public_share_token": null,
  "metadata": null,
  "created_at": "2025-10-22T10:00:00Z",
  "updated_at": "2025-10-22T12:15:47Z"
}

​
Notes

Authentication required: Users can only retrieve their own chats.

Authorizations

​
Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Path Parameters

​
id
string<uuid>
required

Chat ID

Response

Chat retrieved successfully

​
id
string<uuid>
​
name
string
​
user_id
string<uuid>
​
resource_type
enum<string>
Available options:
api,
workflow,
agent,
gui
​
resource_id
string
​
is_public
boolean
​
public_share_token
string | null
​
metadata
object
​
created_at
string<date-time>
​
updated_at
string<date-time>