> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xano.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Xano Metadata API (Account & Snippets)

> Endpoints for validating access tokens, listing/browsing instances, and managing snippet tokens and visibility.

# Overview

The **Metadata API** is the next evolution of the Developer API. It lets you programmatically manage schema and content for your Xano instances and uses **Bearer access tokens** for authentication.

**Base URL:** `https://app.xano.com/api:meta`

> ⚠️ **Beta:** The Metadata API is currently in **beta**.

## Authentication

All endpoints below require a Bearer token unless noted otherwise.

```http theme={null}
Authorization: Bearer <YOUR_ACCESS_TOKEN>
```

Example using `curl`:

```bash theme={null}
curl -H "Authorization: Bearer $XANO_ACCESS_TOKEN" \
  https://app.xano.com/api:meta/auth/me
```

***

# API Endpoints

## Authentication

<CardGroup cols={1}>
  <Card title="Get authorized user" icon="user" href="/xano-features/metadata-api/account_api/auth_me">
    Returns the authorized user's basic account information
  </Card>
</CardGroup>

## Instance Management

<CardGroup cols={2}>
  <Card title="Browse instances" icon="database" href="/xano-features/metadata-api/account_api/browse-instances">
    Returns a list of instances linked to your Xano account
  </Card>

  <Card title="Get instance" icon="database" href="/xano-features/metadata-api/account_api/get-instance">
    Returns details for a specific instance by name
  </Card>
</CardGroup>

## Snippet Management

<CardGroup cols={2}>
  <Card title="List snippets owned by the authenticated user" icon="code" href="/xano-features/metadata-api/account_api/list-snippets">
    Returns a paginated list of snippets owned by the authenticated user
  </Card>

  <Card title="Get a specific snippet by ID" icon="code" href="/xano-features/metadata-api/account_api/get-a-specific-snippet-by-id">
    Returns details for a specific snippet by its canonical ID
  </Card>

  <Card title="Update settings on the snippet" icon="settings" href="/xano-features/metadata-api/account_api/update-settings-on-the-snippet">
    Updates the settings for a specific snippet
  </Card>
</CardGroup>

## Snippet Token Management

<CardGroup cols={2}>
  <Card title="Returns a list of tokens for a snippet" icon="key" href="/xano-features/metadata-api/account_api/returns-a-list-of-tokens-for-a-snippet">
    Returns a list of install tokens for a specific snippet
  </Card>

  <Card title="Creates a new install token on the snippet" icon="plus" href="/xano-features/metadata-api/account_api/creates-a-new-install-token-on-the-snippet">
    Creates a new install token for a specific snippet
  </Card>

  <Card title="Updates a snippet token" icon="edit" href="/xano-features/metadata-api/account_api/updates-a-snippet-token">
    Updates the settings for a specific snippet token
  </Card>

  <Card title="Deletes a snippet token" icon="trash" href="/xano-features/metadata-api/account_api/deletes-a-snippet-token">
    Deletes a specific snippet token
  </Card>
</CardGroup>

***

# Common errors

* **400** — Input Error. Check the request payload for issues.
* **401** — Unauthorized.
* **403** — Access denied. Additional privileges are needed.
* **404** — Not Found.
* **429** — Rate Limited.
* **500** — Unexpected error.

***

# Changelog

* **v0.0.1** — Initial beta endpoints for account, instances, and snippet token management.