跳到主要内容

updateClient

updateClient(clientId, UpdateClientRequest)

PUT /api/2.0/oauth2/clients/{clientId}

Update an existing OAuth2 client

Updates the mutable settings of an existing client and answers 200 with an empty body. Only the fields carried in the request body change; the client ID, the secret, the tenant and the creator cannot be changed this way. An administrator may update any client of the tenant, a plain user only the clients they created, and a client the caller may not see is reported as not found rather than as forbidden. The write runs under optimistic locking and is retried a few times, so a request that still loses the race is rejected with 400 instead of silently overwriting a concurrent change. Nothing is returned in the body - read the client back to see the stored result.

Parameters​

NameInTypeDescriptionNotes
clientIdpathStringID of the client to update[required] [example: 6c7cf17b-1bd3-47d5-94c6-be2d3570e168] [minLength: 1]
UpdateClientRequestbodyUpdateClientRequest[required]

Responses​

Status codeDescriptionTypeResponse headers
200Client successfully updated--
400Missing required fields, validation failed, or the client could not be updated because of concurrent modificationProblemDetail-
403Insufficient permissions to update clientProblemDetail-
404No client with this ID is visible to the caller, or the ID cannot be parsed as a client IDProblemDetail-
415The Content-Type header is not application/jsonProblemDetail-
429Too many requests - rate limit exceededProblemDetail-
500Internal server error occurredProblemDetail-
405The HTTP method is not allowed for this pathProblemDetail-
406The Accept header does not allow application/jsonProblemDetail-

Return type​

null (empty response body)

Authorization​

x-signature

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json