# gRPC API Reference

The choice between gRPC and the REST API is a trade-off between convenience and speed. gRPC is a binary protocol and can be more challenging to debug. This interface would be useful when converting an existing vector database to GreenVectors or when vectorizing large amounts of input vectors into a facet. 

The gRPC methods follow the same principles as REST. For each REST endpoint, there is a corresponding gRPC method.

### API URL <a href="#api-urls" id="api-urls"></a>

| Base URL                                                                  |
| ------------------------------------------------------------------------- |
| [https://greenvectors.morphos.ai/](http://greenvectors.morphos.ai/api/v1) |

### Authentication <a href="#authentication" id="authentication"></a>

Bearer Token:

The bearer token will be provided upon request and it is up to the client to keep it secret. Every API call needs to contain this token in order to authenticate and authorize the client.

### Protocol Documentation/Proto files <a href="#authentication" id="authentication"></a>

To locate the gRPC proto files, visit our Github repo: <https://github.com/morphosai/GreenVectors.Protobuf/blob/main/docs/grpc/docs.md>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://morphos.gitbook.io/morphos-ai/getting-started/grpc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.