---
title: "Updates the OAuth settings for this Company."
method: POST
path: "/companies/{identifier}/oauth/settings"
tags: ["companies"]
---

# Updates the OAuth settings for this Company.

`POST /companies/{identifier}/oauth/settings`

Requires the privilege [`COMPANY_SECURITY_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required

## Request body

- UpdateOAuthSettingsRequest — A request to update the OAuth settings for a company
  - `authorizationUri` string, uri, required — OAuth providers authorization endpoint
  - `tokenUri` string, uri, required — OAuth providers token endpoint
  - `userInfoUri` string, uri, required — OAuth providers user info endpoint
  - `clientId` string, required — The clientId created when registering Gremlin with your OAuth provider
  - `clientSecret` string, required — The client secret created when registering Gremlin with your OAuth provider
  - `scope` string — The scope to be used for the OAuth authorization request. (default is 'email')

## Response `default`

default response

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: COMPANY_SECURITY_WRITE

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)