# Gavana Help Center

> One public documentation surface for people using Gavana and agents operating its supported interfaces.

## Instructions for agents

1. Start with the page that matches the requested task, then use the linked canonical API contract for exact parameters and schemas.
2. Inspect a canvas before making a decision or write. Use only Gavana handles returned by the service; never invent a handle, model, endpoint, or scope.
3. Ask for explicit current-turn approval before saving an image or starting image, workflow, or video work. Never automatically retry potentially paid work.
4. Keep OAuth and Agent Access credentials out of messages, URLs, logs, screenshots, and repositories. Return durable handles or a review link; share only X-Request-ID with support.

## Canonical machine contracts

- [Canvas API OpenAPI 3.1](https://app.gavana.ai/openapi/canvas-agent-v1.json)
- [Canvas API compact reference](https://app.gavana.ai/openapi/canvas-agent-v1.md)
- [Gavana API and CLI context](https://app.gavana.ai/llms-full.txt)

## Help pages

- [How Sync Works in Gavana](https://help.gavana.ai/account-sync/how-sync-works/): Gavana stores canvases locally first, then syncs to your account — what that means for your data.
- [Account & Sync](https://help.gavana.ai/account-sync/): How Gavana's local-first storage and account sync work together.
- [Reading Your Sync Status in Gavana](https://help.gavana.ai/account-sync/sync-status/): What the sync status indicator on the Gavana Canvas Library means.
- [Admin Canvas Viewer: Read-Only Review](https://help.gavana.ai/admin/admin-canvas-viewer/): How admins can open another member's canvas in read-only mode in Gavana.
- [All Members: Reviewing Every User's Canvases](https://help.gavana.ai/admin/all-members/): How the Gavana admin All Members view combines profiles, canvases, and image assets — and how to read it.
- [Admin](https://help.gavana.ai/admin/): Admin-only Gavana features: reviewing every member's canvases, read-only canvas review, and managing feature requests.
- [How to Submit and Manage Feature Requests in Gavana](https://help.gavana.ai/admin/manage-feature-requests/): Submit a feature request from any canvas, and review requests as an admin.
- [Canvas API Reference](https://help.gavana.ai/agent-access/api-reference/): Use Gavana's stable V1 Canvas API contract from a CLI, MCP client, or your own integration.
- [Gavana CLI Reference](https://help.gavana.ai/agent-access/cli-reference/): Commands, exit codes, and output format for the Gavana CLI.
- [Connect Gavana to ChatGPT](https://help.gavana.ai/agent-access/connect-via-chatgpt/): Connect ChatGPT to Gavana's hosted OAuth MCP to inspect canvases and make explicitly approved canvas, workflow, image, or video work.
- [Connect Gavana to Claude or Codex via MCP](https://help.gavana.ai/agent-access/connect-via-mcp/): Use Gavana's local stdio MCP for advanced Claude, Codex, and developer automation.
- [How to Create an Agent Access Token in Gavana](https://help.gavana.ai/agent-access/create-an-agent-access-token/): Create a scoped Agent Access token so a CLI or AI agent can work with your Gavana canvases.
- [Build with Gavana](https://help.gavana.ai/agent-access/): Use Gavana with ChatGPT, Claude, Codex, a terminal, or your own integration—with one clear contract for people and agents.
- [How to Install and Log In to the Gavana CLI](https://help.gavana.ai/agent-access/install-the-cli/): Install the Gavana CLI and use the smallest appropriate login for terminal automation.
- [Gavana Agent Quickstart](https://help.gavana.ai/agent-access/quickstart/): Connect Gavana safely, inspect a canvas first, and make your first reversible handoff with an agent.
- [Reusable Workflows and Video](https://help.gavana.ai/agent-access/workflows-and-video/): Create repeatable Gavana workflows and start image or video work with explicit approval, exact models, and resumable status checks.
- [Batch Prompts or Reference Images with a List Node](https://help.gavana.ai/ai-generation/batch-with-lists/): Use a List node in Gavana to generate multiple images from a batch of prompts or reference images at once.
- [How to Edit an Image with Reference Images in Gavana](https://help.gavana.ai/ai-generation/edit-an-image-with-reference-images/): Use reference images to edit an existing image node in Gavana instead of generating from scratch.
- [How to Generate an Image from a Prompt in Gavana](https://help.gavana.ai/ai-generation/generate-an-image-from-a-prompt/): Generate an image on a Gavana canvas by describing what you want in the Image generation panel.
- [AI Image Generation](https://help.gavana.ai/ai-generation/): Generate and edit images on a Gavana canvas: prompting, reference images, retrying failed generations, and batching with lists.
- [Retry and Regenerate: Fixing a Failed Image Generation](https://help.gavana.ai/ai-generation/retry-and-regenerate/): What to do when an image generation fails or doesn't look right in Gavana.
- [How to Create a Brand Manually in Gavana](https://help.gavana.ai/brand-kit/create-a-brand-manually/): Build a Gavana brand kit by hand instead of importing from a website.
- [How to Import a Brand from a Website in Gavana](https://help.gavana.ai/brand-kit/import-a-brand-from-a-website/): Import a brand kit into Gavana directly from a website URL — logo, colors, and fonts are pulled in automatically.
- [Brand Kit & Import](https://help.gavana.ai/brand-kit/): Import a brand from its website or build one manually, then reuse its logo, palette, and voice on the canvas.
- [Using Your Brand Kit on the Canvas](https://help.gavana.ai/brand-kit/use-your-brand-on-the-canvas/): Reference of what a Gavana brand kit contains and how to pull it into your canvas work.
- [How to Add a Text Node or Sticky Note in Gavana](https://help.gavana.ai/canvas-basics/add-a-text-or-sticky-node/): Add text nodes and sticky notes to a Gavana canvas from the toolbar.
- [How to Add an Image Node in Gavana](https://help.gavana.ai/canvas-basics/add-an-image-node/): Add an image node to a Gavana canvas — generate one with AI, upload a file, or pull from your assets or brand kit.
- [Canvas Navigation Reference](https://help.gavana.ai/canvas-basics/canvas-navigation/): How to pan, zoom, select, and resize on a Gavana canvas.
- [How to Connect Nodes in Gavana](https://help.gavana.ai/canvas-basics/connect-nodes/): Draw connections between nodes on a Gavana canvas to link prompts, context, and images.
- [Canvas Basics](https://help.gavana.ai/canvas-basics/): The building blocks of a Gavana canvas: text nodes, image nodes, sticky notes, connections, and navigation.
- [Canvas Library Overview](https://help.gavana.ai/getting-started/canvas-library-overview/): What you can do from the Gavana Canvas Library: create, import, export, delete, and submit feature requests.
- [How to Create Your First Canvas in Gavana](https://help.gavana.ai/getting-started/create-your-first-canvas/): Step-by-step guide to creating a new canvas in Gavana and saving your first nodes to it.
- [Getting Started with Gavana](https://help.gavana.ai/getting-started/): New to Gavana? Start here to sign in, understand the Canvas Library, and create your first canvas.
- [Gavana Quick Start](https://help.gavana.ai/getting-started/quick-start/): The shortest path from signing in to Gavana to generating your first AI image on a canvas.
- [How to Export a Canvas in Gavana](https://help.gavana.ai/import-export/export-a-canvas/): Download one or more Gavana canvases as a JSON file, including referenced images.
- [How to Import a Canvas in Gavana](https://help.gavana.ai/import-export/import-a-canvas/): Restore a previously exported Gavana canvas from a JSON file.
- [Import & Export](https://help.gavana.ai/import-export/): Export a Gavana canvas to a JSON file with embedded assets, and import it back.
- [Gavana Help Center](https://help.gavana.ai/): Welcome to the Gavana help center. Find guides on canvases, AI image generation, brand kits, import/export, and agent access.
- [Fix: Images Show Up but the Canvas Is Missing](https://help.gavana.ai/troubleshooting/canvas-shows-assets-but-no-canvases/): What to do when images are visible but the expected canvas is missing from Gavana.
- [Common Gavana Issues](https://help.gavana.ai/troubleshooting/common-issues/): Quick fixes for the most common problems in Gavana: sync, imports, and image generation.
- [Troubleshooting](https://help.gavana.ai/troubleshooting/): Fixes for common Gavana issues: missing canvases, sync problems, and failed image generation.