---
title: "List the rooms this credential can reach"
method: GET
path: "/orgs/v1/{org_id}/rooms"
tags: ["AgentMessaging"]
---

# List the rooms this credential can reach

`GET /orgs/v1/{org_id}/rooms`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/{org_id}/rooms`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Enumeration is DERIVED from use: a key nobody has written under is not a room and is not listed. The visibility filter is applied in SQL and returns exactly the set per-room authorization would admit one at a time — a member reaches all the org's rooms; a grant key or project grant reaches the org's named rooms plus the default rooms of the projects it holds, never a sibling project's; a project service_key reaches only its own. Never lifecycle-gated.

## Path parameters

- `org_id` string, uuid, required

## Response `200`

Rooms, newest activity first

- object
  - `rooms` AgentRoomSummary[], required
    - `org_id` string, uuid, required
    - `room_key` string, required
    - `project_id` unknown, required
    - `live_presences` integer, required: Presences that have not yet expired (~1h of silence).
    - `last_activity_at` string, date-time, required: Most recent presence/message/claim activity; null for a key nothing has been written under.

## Other responses

- `401`: Missing or invalid auth
- `403`: No membership, grant, or project credential reaching this org (never a 404 existence oracle — an empty 200 would confirm the org exists)

---

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