Auth - Settings

Upsert OAuth provider credentials

Stores or updates OAuth credentials for a provider and returns the derived callback URL the developer should register with that provider.

put/api/auth/settings/oauth/{provider}

Request

  • Base URL: https://api.ascendkit.dev (the document declares no server; this is the origin it was published from)
  • URL: https://api.ascendkit.dev/api/auth/settings/oauth/{provider}
  • Auth: API key in header X-AscendKit-Public-Key and HTTP bearer

Path parameters

providerstring required

Request body

clientIdstring required

OAuth client ID issued by the provider.

clientSecretstring required

OAuth client secret issued by the provider.

callbackUrlstring nullable

Optional absolute callback override. Leave empty to use the derived redirect URI for the active OAuth flow.

Example request

{
  "clientId": "google-client-id.apps.googleusercontent.com",
  "clientSecret": "super-secret-value",
  "callbackUrl": "https://your-app.com/api/auth/callback/google"
}

Response

Successful Response

dataunknown
errorstring nullable
metaobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.