---
title: "List VetsGPT chats"
method: GET
path: "/workspaces/{workspaceId}/vetsgpt/chats"
tags: ["vetsgpt"]
---

# List VetsGPT chats

`GET /workspaces/{workspaceId}/vetsgpt/chats`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/workspaces/{workspaceId}/vetsgpt/chats`
- Auth: HTTP bearer

Lists owned and explicitly shared VetsGPT chats in this workspace, newest first by conversation activity, with stable chat-id ordering for ties. Not paginated; every chat is returned. Each chat's `searchable_content` is included only when `searchQuery` is given and the actor may access that search projection.

## Path parameters

- `workspaceId` string, required: Identifier of the workspace (clinic). The caller must be a member, and VetsGPT must be enabled for them in this workspace.

## Query parameters

- `searchQuery` string: Optional case-insensitive substring to match against chat titles and message text. Leading and trailing whitespace is ignored; an empty value lists every chat. `%` and `_` act as wildcards.

## Response `200`

A list of VetsGPT chat summaries.

- VetsgptChatListItem[]
  - `sharing` object, required: Owner and effective sharing summary; underlying clinical source access is not granted by chat sharing.
    - `permission` 'owner' | 'view' | 'contribute', required: The current actor's effective permission for this chat.
    - `owner` object, required: The chat's owner identity.
      - `id` string, required: User ID of the chat owner; grants do not transfer ownership.
      - `name` string, nullable, required: Owner display name, or null when unavailable.
    - `isShared` boolean, required: Whether at least one current workspace member has an explicit grant.
    - `recipientCount` number, required: Number of current explicitly granted recipients, excluding the owner.
    - `firstRecipientName` string, nullable, required: First recipient display name for a compact sharing summary, or null.
  - `chat_id` string: Chat id. Use it as `chatId` in the other VetsGPT endpoints.
  - `title` string: Chat title as shown in the VetsGPT sidebar.
  - `created_at` string: When the chat was created (ISO-8601 UTC).
  - `last_updated_at` string: When the chat last changed (ISO-8601 UTC).
  - `searchable_content` string: Plain-text log of the chat's message text (questions, extracted file text and most answers) that `searchQuery` is matched against. Only returned when `searchQuery` is given. Not intended for display; it grows with the chat and can be large.

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/vetnio/apis/vetnio-api.md) - [All operations](https://skmtc.dev/vetnio/apis/vetnio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vetnio/apis/vetnio-api/revisions/d004afd5617d?raw)