---
title: "List Oauth Registrations"
method: GET
path: "/api/v1/connections/oauth/registrations"
tags: ["Connections"]
---

# List Oauth Registrations

`GET /api/v1/connections/oauth/registrations`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `api/v1/login`
  - API key in query parameter `x-api-key`
  - API key in header `x-api-key`

List the registrations a caller may name in an authorization request.

Registration configuration is operator-only, so a client had no way to learn
the ids that ``POST /connections/{connection_id}/oauth/start`` accepts, or the
scope ceiling it must stay inside. Only availability and non-secret fields are
returned, and a registration that this deployment would refuse is omitted
rather than advertised: a picker must not offer consent that cannot start.

## Query parameters

- `provider` string, nullable
- `flow_id` string, uuid, nullable
- `project_id` string, uuid, nullable

## Response `200`

Successful Response

- OAuthRegistrationListRead
  - `registrations` OAuthRegistrationRead[], required
    - `allowed_tenants` string[], required: Workspaces or domains the provider account must belong to.
    - `client_type` 'confidential' | 'public', required
    - `context` 'self_managed' | 'hosted' | 'desktop', required
    - `id` string, required
    - `profile` 'user' | 'bot', required
    - `provider` string, required
    - `scopes` string[], required: The operator's ceiling; a start request selects a nonempty subset.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `4349fbe90c64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/connections/oauth/registrations/get.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) - [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/4349fbe90c64?raw)