Authorized Apps API
Reference for the Authorized Apps endpoint group — 2 endpoints.
Generated from the live OpenAPI spec. Re-run _generate_api_reference.py after backend changes.
Authentication#
All endpoints require a Bearer JWT in the Authorization header unless noted otherwise. See Concepts → Tokens and scopes and Reference → OAuth endpoints for how to obtain one.
Endpoints#
GET /api/v1/me/authorized-apps#
List Authorized Apps
List all applications the user has authorized (via OAuth consent).
Parameters:
| Name | In | Required | Type | Description |
|---|---|---|---|---|
authorization |
header | no | string | null |
Responses:
| Status | Body |
|---|---|
200 |
application/json → object |
422 |
application/json → HTTPValidationError |
DELETE /api/v1/me/authorized-apps/{client_id}#
Revoke App Authorization
Revoke a user's authorization for an application.
Removes the consent grant AND revokes the application's live refresh tokens
for this user, so "revoke access" actually severs the app's ability to mint
new access tokens (existing self-contained access tokens expire at their
own exp; a refresh can no longer extend them).
Parameters:
| Name | In | Required | Type | Description |
|---|---|---|---|---|
client_id |
path | yes | string |
|
authorization |
header | no | string | null |
Responses:
| Status | Body |
|---|---|
200 |
application/json → object |
422 |
application/json → HTTPValidationError |
Schemas#
Definitions for every type referenced by the endpoints above. Schema-to-schema references on this page link within the page; cross-page references would require visiting the linked page.
HTTPValidationError#
| Field | Type | Required | Description |
|---|---|---|---|
detail |
array of ValidationError |
no |
ValidationError#
| Field | Type | Required | Description |
|---|---|---|---|
loc |
array of string | integer |
yes | |
msg |
string |
yes | |
type |
string |
yes |