# Get an assistant chat

### Get an assistant chat

`GET /api/v1/assistant-chats/{assistantChatId}`

Operation ID: `getAssistantChat`

A chat the user had with the assistant inside the Needle web app, to continue it elsewhere. When `handoff` is set, the assistant passed the task on: its `brief` holds the goal, the ids involved, what was already found, and what is left. Messages hold each turn’s text and the tools it called. Calls since the last user message keep their results; earlier ones do not. Only the user who had the chat can read it.

**Path parameters**

- `assistantChatId` (string · uuid, required): Assistant chat id

**200**: The chat.

- `assistantChat` (object, required)
  - `id` (string · uuid, required)
  - `title` (string, required)
  - `createdAt` (string · date-time, required)
  - `updatedAt` (string · date-time, required)
  - `handoff` (object | null, required): Set when the assistant passed the task on. Null when the chat was not handed off.
    - `task` (string, required): One line naming the task for the agent that picks this chat up.
    - `brief` (string, required): Everything the next agent needs to continue: the goal, the ids involved, what was already found, and what is left.
  - `messages` (object[], required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload