---
title: "List connected apps"
method: GET
path: "/v1/connected-apps"
tags: ["connected-apps"]
---

# List connected apps

`GET /v1/connected-apps`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/connected-apps`
- Auth: HTTP bearer

Returns the AI assistants and other MCP clients that people in this workspace connected with OAuth: the client, who connected it, its permissions, the location it is pinned to, and when it was last used. You see a connection only where you hold the permission to view API keys at its location.

**Notes.**
- Newest first. Only connections whose location the caller can see with `api-key.view` are listed.

## Response `200`

Success.

- object
  - `data` object[], required
    - `id` string, required: Connection id.
    - `clientId` string, required
    - `clientName` string, required: The app's name, as it registered.
    - `redirectHost` string, nullable, required: The host the app signs in through.
    - `connectedBy` object, nullable, required: The person who approved it; null if they no longer exist.
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `permissions` union, required
      - 'all'
      - string[]
    - `nodeId` string, nullable, required: The location the connection is limited to; null for the whole workspace.
    - `lastUsedAt` string, nullable, required: ISO-8601 timestamp (UTC).
    - `connectedAt` string, required: ISO-8601 timestamp (UTC).
    - `recent` object[], nullable, required: The connection's latest actions (up to 5), newest first. Null without `audit-log.view`.
      - `id` string, required
      - `action` string, required: The audit action, e.g. `playlist.updated`.
      - `summary` string, required: The action in words, e.g. "Playlist updated".
      - `detail` string, nullable, required
      - `at` string, required: ISO-8601 timestamp (UTC).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/7c2741bcdb16?raw)