RoleService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
RoleService
Section titled “RoleService”Provides authenticated reads for public role metadata.
ListRoles
Section titled “ListRoles”Lists the current role catalog as a finite snapshot. Requires an authenticated user.
POST /api/connect/chatto.api.v1.RoleService/ListRolesInput: ListRolesRequest
Section titled “Input: ListRolesRequest”Request the current role catalog.
Result: ListRolesResponse
Section titled “Result: ListRolesResponse”Snapshot of the role catalog visible to the authenticated viewer.
| Field | Type | Description |
|---|---|---|
roles | repeated Role | Roles sorted by position. |
GetRole
Section titled “GetRole”Gets one public role by stable name. Returns NOT_FOUND when the role is unknown.
POST /api/connect/chatto.api.v1.RoleService/GetRoleInput: GetRoleRequest
Section titled “Input: GetRoleRequest”Request one public role by stable role name.
| Field | Type | Description |
|---|---|---|
name | string | Required stable role name. |
Result: GetRoleResponse
Section titled “Result: GetRoleResponse”Public role lookup response.
| Field | Type | Description |
|---|---|---|
role | Role | Requested role. |
BatchGetRoles
Section titled “BatchGetRoles”Gets public role records for multiple role names referenced by member rows, mentions, or integration clients.
POST /api/connect/chatto.api.v1.RoleService/BatchGetRolesInput: BatchGetRolesRequest
Section titled “Input: BatchGetRolesRequest”Request public role records for a set of stable role names.
| Field | Type | Description |
|---|---|---|
names | repeated string | Required role names. Unknown names are omitted from the response. |
Result: BatchGetRolesResponse
Section titled “Result: BatchGetRolesResponse”Batch public role response.
| Field | Type | Description |
|---|---|---|
roles | repeated Role | Found roles. The server preserves first-seen request order and de-duplicates repeated names. |