# Vani API Documentation

Here's everything you need to get started with the Vani API. Whether you're building integrations or automating workflows, this guide has you covered.

- Operations: 171
- OpenAPI documents: 14
- OpenAPI version: 3.1.0
- Data centres: 7

## Core API

| Group | Operations | Description |
|---|---|---|
| [Editions](resources/editions.md) | 8 | Edition-level resources: the edition itself, its subscription, join requests, and templates. |
| [Teams](resources/teams.md) | 15 | Teams within an edition, their members, join requests, and role lookups. |
| [Spaces](resources/spaces.md) | 17 | Spaces (projects) within an edition, their members, join requests, and role lookups. |
| [Zones](resources/zones.md) | 12 | Zones (documents) within a space: lifecycle, metadata, versioning, and per-zone sharing. |
| [Elements](resources/elements.md) | 34 | Create, read, update, and delete the objects on a zone canvas: shapes, connectors, group shapes, frames, and their text. |
| [Search](resources/search.md) | 5 | Content search across a team's zones, frames, comments, and members. |
| [External Share](resources/external-share.md) | 6 | Publish a space externally and manage the resulting public share. |

## Zone Operations (transitional)

| Group | Operations | Description |
|---|---|---|
| [Structures](resources/structures.md) | 6 | Build whole structures in one call — mindmaps, flowcharts, kanban boards, stacks, and tables. |
| [Layout & Placement](resources/layout.md) | 26 | Deterministic placement, alignment, tidy layout, spatial queries, and connector routing. |
| [Navigation & Relationships](resources/navigation.md) | 13 | Traverse the zone hierarchy, resolve relationships, and navigate visually between objects. |
| [Tables](resources/tables.md) | 23 | Cell, row, and column operations on table objects, and typed database_table records and schema. |
| [Text](resources/text.md) | 2 | Read and mutate text on any text-bearing object, including styling. |
| [Data](resources/data.md) | 4 | Low-level batch read and mutation escape hatch over zones, frames, and objects. |

## Authentication

OAuth 2.0 through Zoho Accounts. Every operation declares the scopes it needs; request only those. For example: `Vani.editions.READ`, `Vani.editions.CREATE`, `Vani.editions.UPDATE`, `Vani.teams.READ`.