---
title: "REST API reference (Preview)"
component: "savanna"
version: "main"
module: "rest-api"
html_url: "/savanna/main/rest-api/index.html"
---

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

# REST API reference (Preview)

Control-plane REST API for managing TigerGraph Savanna (workgroups, workspaces, and related resources) via `api.tgcloud.io`.

For data-plane queries on a workspace, see [Connect via APIs](../workgroup-workspace/workspaces/connect-via-api.md). For agent-based access, see [Connect AI tools with MCP](../get-started/connect-agent-mcp.md).

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

## Reference

| [Authentication](authentication.md) Authenticate to the control plane before you call any endpoint. | [Endpoints](endpoints.md) Browse the available control-plane endpoints. |
| --- | --- |
| [Definitions](definitions.md) Look up request and response schemas used by the API. | [Create an API key](../administration/settings/how2-create-api-key.md) Generate a key for scripts and services that call the control plane. |

## Where to go next

* [Connect via APIs](../workgroup-workspace/workspaces/connect-via-api.md) for data-plane curl, Python, and JavaScript examples.
* [Connect AI tools with MCP](../get-started/connect-agent-mcp.md) when you want an AI agent to work against your database.