Schemas

gRPC

The service definition and message types are in the project’s proto file: common/proto/perimeter.proto. Use it to generate client code or to inspect types with grpcurl describe. The server supports gRPC reflection so tools can discover the schema without the file.

REST

The token API request/response shapes are in the OpenAPI spec at /api-docs/openapi.json and the Swagger UI at /swagger-ui on the API host. Main shapes: GetTokenRequest (right, created_by, description), TokenResponse (token), RevokeTokenRequest, RefreshTokenRequest, ListTokensResponse (tokens array with metadata). All use JSON.

WebSocket

Message payloads are often JSON with tenant, channel, and payload. Payload can be a string or base64-encoded binary. Confirm the exact envelope and subscribe/publish message format with your deployment or operator docs.