---
title: "List Genie conversations"
method: GET
path: "/v1/workspaces/{workspace_id}/genies/conversations"
tags: ["Genie conversations"]
---

# List Genie conversations

`GET /v1/workspaces/{workspace_id}/genies/conversations`

## Request

- Base URL: `https://api.stacksync.com`
- URL: `https://api.stacksync.com/v1/workspaces/{workspace_id}/genies/conversations`
- Auth: HTTP bearer

The Genie conversations of a workspace in one region, newest activity first, in cursor pages.

## Path parameters

- `workspace_id` integer, required

## Query parameters

- `region` 'besg' | 'usnv', required
- `genie_id` string, uuid, nullable: Only the conversations of this genie
- `limit` integer: Maximum number of conversations returned, at most 100
- `cursor` string, nullable: next_cursor of the previous page

## Response `200`

OK

- GenieConversationList
  - `data` GenieConversationSummary[], required
    - `conversation_id` string, required
    - `genie_id` string, nullable
    - `genie_name` string, nullable
    - `name` string, nullable
    - `status` string, nullable
    - `status_label` string, nullable
    - `last_activity_time` string, nullable
    - `message_count` integer
    - `step_count` integer
  - `has_more` boolean, required
  - `next_cursor` string, nullable: Pass it as cursor for the next page

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

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