Update OAuth client

PUT

/oauth-clients/{client-id}

Last modified:2026-10-30 21:26:59

OperationId:updateOauthClient

Changes an OAuth client's redirect URI or secret, or rotates the secret. Requires Super User scope. The stored secret is kept unless you send regenerate-secret=yes or a new client-secret.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The secret was rotated. The response carries the new secret, and a rotation is the only change that returns one. Update every integration that uses the old secret.

Bodyapplication/json

🟢202Accepted

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/oauth-clients/app.example.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "redirect-uri": "https://app.example.com/oauth/callback2"
}'

Response Example

200 - Rotate the secret

{
    "client-id": "app.example.com",
    "client-secret": "{{client_secret}}",
    "notes": "The client secret was regenerated. Every integration using the previous secret must be updated."
}

Modified at 2026-10-30 21:26:59

Read OAuth client

Delete OAuth client