Conversations

Find rooms (conversations) and pods by name. This is the one tool that turns “the launch room” into an id; every other tool takes the id.

Tool	Scope	Kind
`list_conversations`	`conversations:read`	read-only

list_conversations

Scope: conversations:read (step-up) · Kind: read-only · Annotations: readOnlyHint: true, destructiveHint: false, openWorldHint: false

The rooms (conversations) and pods you can reach, newest activity first — how to turn a name like “the launch room” into the conversation_id and pod_id the document tools take. Pass pod as a pod id, slug or name to list one pod’s rooms; with no pod, every pod you belong to is listed with its newest rooms. query narrows by room title. A name matching two pods is refused with the candidates (pod_ambiguous): pick one and call again with its id. truncated: true means more rooms exist — narrow with pod or query. Artifact rooms are not listed; reach a document’s own room through read_document’s parent.

Parameters

string

A pod id, its slug, or its name. Names match case-insensitively, exactly first and then as a substring, so launch finds “Product Launch” when it is the only pod with that word. Omit to span every pod you can see.

string

Words from the room title. A ranked title search inside the selected pod (or each pod, without pod).

boolean

default:"false"

Include archived rooms.

number

default:"50"

Rooms to return, 1 to 50. Clamped.

Returns

array

The pod named by pod, or every pod you can see.

Show pod

string

Pass to create_document (scope: "pod") and list_documents.

string

'open' | 'restricted'

'editor' | 'member' | null

Your role in the pod; null when you are not a member (an org admin, or an open pod you have not joined).

boolean

Whether you may administer the pod.

array

Rooms, newest activity first.

Show room

string

Pass to create_document and list_documents.

string

'active' | 'archived'

number

Milliseconds since epoch.

boolean

true when more rooms exist than were returned, or when a workspace-wide listing stopped after 50 pods. There is no cursor; narrow with pod or query.

Text, pods first then rooms:

- pod <name> — pod_id: <id>, slug <slug>, open, your role editor

- <title> [active] — conversation_id: <id>, in <pod name>, active <ISO time>
[…more rooms not listed]

Permissions and side effects

Needs conversations:read. The first call triggers the host’s step-up consent for it.
The pods you can see are exactly the pod switcher’s: open pods, restricted pods you belong to, and every pod for an org admin. A restricted pod you are not in is absent, not locked.
A document’s own discussion room is never listed here; it is reached from the document (parent on read_document).
Reads only. Recorded in the agent activity history.

Errors

Text	Cause
`Tool failed: … Pod not found`	`pod` names nothing you can see: no such id, slug or name, or a restricted pod you are not in
`\`pod` matches more than one pod: …`with`error: “pod_ambiguous”`,` candidates`	The name matched two or more pods. Call again with one `pod_id` from `candidates`.

Example

Request

{ "name": "list_conversations", "arguments": { "pod": "launch", "query": "checklist" } }

Response (structuredContent)

{
  "pods": [
    {
      "pod_id": "p31growthpod00000000000000000000",
      "name": "Product Launch",
      "slug": "product-launch",
      "visibility": "open",
      "my_role": "editor",
      "can_manage": true
    }
  ],
  "conversations": [
    {
      "conversation_id": "j52launchroom0000000000000000000",
      "title": "Launch checklist",
      "pod_id": "p31growthpod00000000000000000000",
      "pod_name": "Product Launch",
      "status": "active",
      "last_activity_at": 1757160729000
    }
  ],
  "truncated": false
}

Then create_document with that conversation_id posts the document’s card into the room.

Get started

Use it

Reference

list_conversations

Parameters

Returns

Permissions and side effects

Errors

Example

​list_conversations

​Parameters

​Returns

​Permissions and side effects

​Errors

​Example

list_conversations

Parameters

Returns

Permissions and side effects

Errors

Example