# Get one bot template (/docs/api-reference/api/v1/bots/slug/get)

`GET https://mmb-blurware-alpha.vercel.app/api/v1/bots/{slug}`

Get one bot template

Operation ID: `getBot`

OpenAPI document: https://mmb-blurware-alpha.vercel.app/openapi.json

## Authentication

Optional bearer token: `Authorization: Bearer $MMB_API_KEY`. Public bot templates also accept keyless requests at a lower rate limit.

## Request

### Path parameters

```json
[
  {
    "schema": {
      "type": "string"
    },
    "required": true,
    "name": "slug",
    "in": "path"
  }
]
```

## Responses

### `200` — The bot template.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Stable identifier used in /api/v1/bots/{slug}."
    },
    "name": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "description": "Directory category."
    },
    "who": {
      "type": "string",
      "description": "Who runs this bot."
    },
    "handle": {
      "type": "string",
      "description": "Public handle of the operator."
    },
    "job": {
      "type": "string",
      "description": "What the bot does."
    },
    "templateUrl": {
      "type": "string",
      "description": "Public template link."
    },
    "addedAt": {
      "type": "number",
      "description": "Unix epoch milliseconds."
    }
  },
  "required": [
    "slug",
    "name",
    "who",
    "handle",
    "job",
    "templateUrl",
    "addedAt"
  ]
}
```

### `401` — The bearer key does not exist.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "invalid_api_key"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```

### `403` — The anonymous key expired or exhausted its quota.

**application/json**

```json
{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "key_expired"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "quota_exhausted"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    }
  ]
}
```

### `404` — No bot template with this slug.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "not_found"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```

### `429` — Too many requests. Mirrors the Retry-After header.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "rate_limited"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```

### `503` — The gateway is unreachable.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "service_unavailable"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```