Skip to content
Chatto v0.5.0

AdminOAuthClientService

Chatto exposes this service below /api/connect.

Shared message and enum definitions are documented in Shared Types And Enums.

Manages OAuth clients authorized through this server. Requires server.manage.

Lists clients that completed at least one authorization. Requires server.manage.

POST /api/connect/chatto.admin.v1.AdminOAuthClientService/ListOAuthClients

Lists OAuth clients with recorded authorizations using offset pagination. Results use first authorization order, oldest first.

FieldTypeDescription
pagechatto.api.v1.PageRequestDefaults to 20 results when absent or limit is zero. Maximum: 100.

One page of OAuth clients in stable first-authorization order.

FieldTypeDescription
oauth_clientsrepeated OAuthClientClients visible to the caller in this page.
pagechatto.api.v1.PageInfoTotal count and whether another page is available.

Gets one recorded client or returns NOT_FOUND. Requires server.manage.

POST /api/connect/chatto.admin.v1.AdminOAuthClientService/GetOAuthClient

Identifies one OAuth client by its exact stable client ID.

FieldTypeDescription
client_idstringExact CIMD URL or built-in application URI.

Returns one OAuth client with a recorded authorization.

FieldTypeDescription
oauth_clientOAuthClientThe requested client.

Replaces a client’s policy and revokes tokens when blocked. Requires server.manage.

POST /api/connect/chatto.admin.v1.AdminOAuthClientService/UpdateOAuthClientPolicy

Replaces the administrative policy for one OAuth client.

FieldTypeDescription
client_idstringExact CIMD URL or built-in application URI.
policyOauthClientPolicyNew complete policy value. Default removes any trusted or blocked label.
update_maskgoogle.protobuf.FieldMaskEditable fields to apply or reset: policy. Omit to infer populated fields; * selects all editable fields. An explicit empty mask is invalid. Unselected values are ignored. A selected absent policy resets to DEFAULT. An explicit UNSPECIFIED value is also a reset when policy is selected by the mask.

Returns the OAuth client with its updated policy.

FieldTypeDescription
oauth_clientOAuthClientThe updated client.