---
title: "Authentication"
component: "savanna"
version: "main"
module: "rest-api"
html_url: "/savanna/main/rest-api/authentication.html"
---

[View as HTML](/savanna/main/rest-api/authentication.html) · [Documentation index](/llms.txt)

# Authentication

To use the TigerGraph Savanna REST APIs, you need to authenticate your requests. Authentication is typically done using API keys.

> [!NOTE]
> The TigerGraph Savanna REST API is currently in preview version. Features and endpoints may change as the API evolves.

## Setup API Keys

Before you can authenticate your API requests, you need to set up your API keys. Please refer to the [API Key Setup](../administration/settings/how2-create-api-key.md) page for detailed instructions on how to generate and manage your API keys.

## Example Request

Here's an example of how to consume the APIs using your API key:

```bash
curl -X GET "https://api.tgcloud.io/controller/v4/v2/workgroups" \
     -H 'Content-Type: application/json' \
     -H "x-api-key: <your-api-key>"
```