---
title: "Remove scopes from an authorized app"
method: PATCH
path: "/me/authorized-apps/{id}"
tags: ["Gateway"]
---

# Remove scopes from an authorized app

`PATCH /me/authorized-apps/{id}`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/me/authorized-apps/{id}`
- Auth: HTTP bearer

Narrows an app's access to the scopes given. Scopes can only be removed; adding one needs your consent in the browser. OAuth token with oauth_clients:write required.

## Path parameters

- `id` string, required

## Request body

- AuthorizedAppScopesRequest
  - `scopes` string[], required: The scopes to keep; each must already be granted.

## Response `200`

Scopes reduced

- AuthorizedAppScopesResponse
  - `data` object, required
    - `id` string
    - `scopes` string[]

## Other responses

- `400`: Empty list, or a scope the app does not have
- `401`: Not an OAuth token, or the token is invalid or expired
- `404`: Authorized app not found

## Changes

- **2026-10-28** `72ba9c856a2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/me/authorized-apps/:id/patch.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)