API Console
test
Sign in with BES

Client Update

Update a client with matching client_id and no nonnull initial_secret; kind, auth method, service account and product are immutable, and disabled clients reject updates. Register the widget as confidential_web with assistant.widget in scopes under its own non-sellable Assistant product. This reserved scope enables host-bound widget authorization; do not grant it to ordinary product clients. GET /authorize requires host_product_id (host product UUID) and assistant.widget in the requested scopes for this client. The host must register an active assistant.chat feature. host_product_id is persisted in authorization_request.requested_audience; issued access-token audience remains the Assistant product. The code transaction binds one current host product_login generation in the same SSO. Missing host admission returns login_required for prompt=none; interactive use must first sign in to the host. Callback URIs are exact environment configuration, locally https://assistant.local.globalbes.sg/widget/callback. No Assistant membership or entitlement is required; no iframe permission is added.

PATCH https://id.test.globalbes.sg:9443/internal/control/v1/clients/{client_id}
Called byPlatform ops AuthService certificate
Path
string
OAuth client identifier.
Headers
uuid
Optional acting person; malformed UUID is denied.
Body
string
Caller supplied idempotency reference, 1 to 255 characters.
uuid
Owning product identifier.
string
Deployment version, 1 to 100 allowed characters.
string
Display name of 1 to 200 characters; nonempty after trimming whitespace.
enum
Client kind.
enum
Client authentication method.
array
Defaults to an empty array; required for web and native clients.
array
Defaults to an empty array.
string
Optional OIDC back-channel logout endpoint; must be an absolute https URL with a host and no userinfo or fragment.
array
Nonempty scope set.
boolean
Defaults to false; required true for native public clients.
enum
Token profile.
uuid
Required for service clients.
object
Public JWK, if applicable.
string
Omit or set null; a nonnull secret is rejected. Use credential rotation to change it.
Sign in to sendBrowsing needs no sign-in
Request preview
PATCH /internal/control/v1/clients/{client_id}
Response

Choose an API and send a request.

Caller tags:BOSSTenant adminAll productsMobile appMessagingControlAIAssistantPlatform opsLegacy productsCI release