Skip to main content
Bruno provides comprehensive support for gRPC requests, enabling you to test and interact with gRPC services directly from the interface. With Bruno’s gRPC support, you can:
  • Add Proto files for enhanced IntelliSense and method discovery
  • Use Server Reflection as an alternative to Proto files for automatic method suggestions
  • Call server methods with full parameter support and type validation
  • Test real-time streaming APIs including unary, server streaming, client streaming, and bidirectional streaming

​
gRPC Interface

Bruno gRPC interface provides an intuitive way to interact with gRPC services. The interface automatically adapts based on whether you’re using Proto files or Server Reflection. gRPC Interface

​
Creating a gRPC Request

​
Step 1: Create a gRPC Request

  1. Open the collection context menu and select New Request from the dropdown
create request dialog
  1. Select gRPC as your request type
  2. Enter the service endpoint in the URL field (e.g., https://grpcb.in/)
Create gRPC Request

​
Step 2: Configure the Request

  1. Click on Reflection and choose the method you want to call from the dropdown
Refresh: The gRPC refresh feature caches server information in memory for better performance. If you’re running a local gRPC server and make changes to your service definitions, click the Refresh button next to the Using Reflection toggle to reload the latest changes from your server.
  1. Use the search functionality in the dropdown to quickly find your desired method by typing the method name
Select Method

​
Step 3: Send the Request

  1. Add any required inputs in the message section (auto generate with Auto Fill button)
  2. Click the Send button to execute your gRPC request.
Add Message and Receive Response You’ll see the response in the Response section with detailed information about the request execution.

​
Adding metadata

gRPC uses metadata instead of HTTP headers. Use metadata to send key-value pairs such as access tokens or tenant identifiers with a request.
  1. Open your gRPC request and select the Metadata tab in the request pane.
  2. Click Add Metadata and enter the key and value.
  3. Use the checkbox next to an entry to enable or disable it.
Metadata values support variable interpolation, so you can reference environment or collection variables like {{token}}. For authentication methods such as Basic, Bearer, or API key, use the Auth tab instead of adding metadata manually. To learn about proto files, navigate to the Adding Proto file section.