---
title: "GET /api/oauth/connected_apps"
method: GET
path: "/api/oauth/connected_apps"
tags: ["OAuth"]
---

# GET /api/oauth/connected_apps

`GET /api/oauth/connected_apps`

## Request

- The document declares no server URL.
- Auth: API key in cookie `session`

The apps the signed-in user has connected and that can still act for them. An app unused for thirty days (no refresh) has lapsed and is not listed.

## Response `200`

The request has succeeded.

- ConnectedApps: The signed-in user's Connected Apps, newest first.
  - `items` ConnectedApp[], required
    - `id` integer, required: Handle to revoke it by (not the OAuth client_id, which can be a URL).
    - `name` string, required: Display name the application registered with; untrusted text.
    - `scopes` string[], required: What it may do: OAuth scopes (`catalog:read`, `progress:read`, `admin`, `offline_access`).
    - `connectedAt` string, date-time, required: When the user first connected it (the oldest grant still on file).
    - `clientHost` string: Host of the application's client_id when that is a metadata document URL; absent otherwise.

## Other responses

- `default`: Default error response shared by every operation. `@error` emits an OpenAPI `default` response, keeping central transport failures typed without enumerating every status on every operation.

## Changes

- **2026-10-18** `9380d4c85a04`: 2 info
  - removed the non-success response with the status `401`
  - added the optional property `errors` to the response with the `default` status
- **2026-10-17** `023e7c2cd140`: 1 info
  - endpoint added
- **2026-10-17** `d09902c84ca9`: 1 breaking
  - api path removed without deprecation
- **2026-10-17** `b3e2bb3e440b`: 1 info
  - endpoint added
- **2026-10-17** `6038dca99ed6`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/hexlet-basics/apis/hexlet-basics-api/changes/api/oauth/connected_apps/get.md)

---

[API](https://skmtc.dev/hexlet-basics/apis/hexlet-basics-api.md) · [All operations](https://skmtc.dev/hexlet-basics/apis/hexlet-basics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hexlet-basics/apis/hexlet-basics-api/revisions/51c7f596b47c?raw)