---
api_name: shop-minis
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis/minis-admin-api'
  md: 'https://shopify.dev/docs/api/shop-minis/minis-admin-api.md'
---

# Minis Admin API

##

The Shop Minis Admin API is a GraphQL API that allows you to manage your Mini from a backend application. It includes mutations for enabling/disabling your Mini, verifying user requests, and more.

## Authentication

Shop Minis Admin API requests are authenticated using an API key. Your API key will be generated when you first run the [`setup`](./commands/setup) command. You can find it in your project's `.env` file.

### Examples

* #### Perform a GraphQL request

  ##### Default

  ```bash
  curl -X POST \
    https://server.shop.app/minis/admin-api/alpha/graphql.json \
    -H 'Content-Type: application/graphql' \
    -H 'Authorization: Bearer <shop-minis-admin-api-key>' \
    -d '{your_query}'
  ```

## Rate limiting

The Shop Minis Admin API is rate limited. Requests that are subject to throttling will have a response status code of 429 and include a top-level error with the code `TOO_MANY_REQUESTS`.

### Examples

* #### Rate limiting response

  ##### Default

  ```json
  {
    "data": null,
    "errors": [
      {
        "message": "Slow down there partner.",
        "extensions": {
          "code": "TOO_MANY_REQUESTS"
        }
      }
    ]
  }
  ```

## Mutations

[mini​Toggle](https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/minitoggle)

[Enables or disables the Mini by partner.](https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/minitoggle)

[user​Token​Verify](https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/usertokenverify)

[Verifies a user token.](https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/usertokenverify)