> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bringits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# gRPC Commands

> Call gRPC services natively from an HTTP step: unary calls and the first message of a server stream

gRPC commands call a protobuf service over HTTP/2 and return the response decoded as JSON. They run in **HTTP** steps, next to the other [HTTP Commands](https://docs.bringits.com/stream/commands/http.md).

## When to Use gRPC

Use a gRPC command when the source exposes a gRPC API. For REST or HTML sources, use [HTTP Commands](https://docs.bringits.com/stream/commands/http.md). For a live socket that keeps publishing, use [WebSocket Commands](https://docs.bringits.com/stream/commands/ws.md).

## Supported Calls

| Method kind | Behavior |
| - | - |
| **Unary** | One request, one decoded response. |
| **Server streaming** | The first message is returned, then the call is cancelled. |
| **Client streaming, bidirectional** | Not supported. The command fails with a clear error. |

## Schema

Provide the service definition as one self-contained `.proto` text in `protos.source`, with imports inlined. It is compiled when the project version is saved. Request fields in `body` use the proto field names.

## Limits and Behaviors

| Behavior | Detail |
| - | - |
| **Decoded output** | The response is a JSON object with proto field names. There are no other decode modes. |
| **Statuses** | A non-OK gRPC status fails the item unless it is listed in `bypassGrpcStatus`. A bypassed status returns `null` data. |
| **Unblocker** | The [Unblocker](https://docs.bringits.com/unblocker.md) is not available for gRPC calls. A Link tunnel proxy can be set on `proxy`. |

## Available Commands

> [card] [gRPC Request](https://docs.bringits.com/stream/commands/grpc/grpc-request.md)
>
> Unary call or first message of a server stream (ID 1005)

## Related Commands

* [HTTP Commands](https://docs.bringits.com/stream/commands/http.md) - REST-based data fetching
* [Parse Commands](https://docs.bringits.com/stream/commands/parse.md) - reshape the decoded response


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.