---
title: "Update an OAuth client"
method: PATCH
path: "/auth/connectors/oauth-clients/{oauth_client_id}"
tags: ["AuthConnector"]
---

# Update an OAuth client

`PATCH /auth/connectors/oauth-clients/{oauth_client_id}`

## Request

- Base URL: `https://api.your-domain.com`
- URL: `https://api.your-domain.com/auth/connectors/oauth-clients/{oauth_client_id}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/docs/auth/connectors/oauth-clients/:oauth_client_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update an OAuth client (superadmin only).

## Path parameters

- `oauth_client_id` integer, required: ID of the OAuth client to update.

## Query parameters

- `cookie_name` string, nullable

## Request body

- OAuthClientUpdate
  - `name` string, nullable: New display name for the OAuth client.
  - `description` string, nullable: New description for the OAuth client.
  - `icon_url` string, nullable: URL of an icon representing the OAuth client.

## Response `200`

Successful Response

- OAuthClient
  - `created_at` string, date-time: UTC timestamp when the record was created.
  - `updated_at` string, date-time: UTC timestamp when the record was last updated.
  - `creator_user_id` integer, nullable: ID of the user who created the record, if attributable.
  - `updater_user_id` integer, nullable: ID of the user who last updated the record, if any.
  - `id` integer, nullable: Primary key for the OAuth client.
  - `name` string, required: Unique human-readable name of the OAuth client.
  - `provider_key` 'azure-entra' | 'microsoft' | 'atlassian' | 'hubspot' | 'oidc', required: Enum for OAuth providers.
  - `client_id` string, nullable: OAuth application (client) ID issued by the provider.
  - `description` string, nullable: Optional description of the OAuth client.
  - `icon_url` string, nullable: URL of the icon shown for this OAuth client.
  - `authorize_url` string, required: OAuth authorization endpoint URL.
  - `admin_consent_url` string, nullable: URL for granting tenant-wide admin consent, if applicable.
  - `token_url` string, required: OAuth token endpoint URL.
  - `logout_url` string, nullable: URL used to log the user out of the provider session.
  - `redirect_uri` string, nullable: Redirect URI registered for the OAuth callback.

## Other responses

- `401`: Missing or invalid authentication.
- `403`: Platform operator (superadmin) privileges required.
- `404`: No OAuth client exists with the given id.
- `422`: Validation Error

---

[API](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api.md) - [All operations](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/revisions/b53e89b98c2b?raw)