---
title: "Get chat access"
method: GET
path: "/api/public/organizations/{orgId}/chats/{chatId}/access"
tags: ["Chats"]
---

# Get chat access

`GET /api/public/organizations/{orgId}/chats/{chatId}/access`

## Request

- Base URL: `https://charts.basedash.com`
- URL: `https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/access`
- Auth: HTTP bearer

Retrieves who can view, edit and manage an API chat. Organization admins and the chat creator always have full access and are not listed. Requires view access to the chat.

## Path parameters

- `orgId` string, required: Organization ID
- `chatId` string, required: Chat ID

## Response `200`

Chat access retrieved successfully

- object
  - `data` ChatAccessResponse, required
    - `chatId` string, required: Chat ID
    - `mode` 'everyone' | 'restricted', required: everyone: all members have accessLevel, plus any listed principals. restricted: only listed principals, the creator and admins.
    - `accessLevel` 'MANAGE' | 'EDIT' | 'VIEW' | 'null', nullable, required: Access level for every member when mode is everyone
    - `groupAccess` object[], required: Organization groups and their access level
      - `id` string, required: Organization group or member ID
      - `accessLevel` 'MANAGE' | 'EDIT' | 'VIEW' | 'NONE', required: MANAGE can edit and change access, EDIT can edit, VIEW can view. NONE explicitly denies this principal, overriding group or everyone access.
    - `memberAccess` object[], required: Organization members and their access level
      - `id` string, required: Organization group or member ID
      - `accessLevel` 'MANAGE' | 'EDIT' | 'VIEW' | 'NONE', required: MANAGE can edit and change access, EDIT can edit, VIEW can view. NONE explicitly denies this principal, overriding group or everyone access.

## Other responses

- `401`: Unauthorized - Missing or invalid API key
- `404`: Not found - Chat not found or no access to it
- `429`: Rate limit exceeded - Too many requests
- `500`: Internal server error

---

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