# Mint an anonymous API key (/docs/api-reference/api/v1/auth/agent/post)

`POST https://mmb-blurware-alpha.vercel.app/api/v1/auth/agent`

Mint an anonymous API key

Creates a new anonymous key with a lifetime request cap and an expiry. The key is returned once; store it. Claim it by email to remove the expiry and cap.

Operation ID: `mintAgentKey`

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

## Authentication

Public endpoint; no bearer token is required.

## Request

This operation has no request parameters or body.

## Responses

### `200` — Key minted.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Shown once. Store it."
    },
    "tenantId": {
      "type": "string"
    },
    "claimToken": {
      "type": "string",
      "description": "Use with POST /api/v1/auth/claim."
    },
    "claimUrl": {
      "type": "string",
      "description": "Human-readable claim instructions."
    },
    "expiresAt": {
      "type": "number",
      "description": "Anonymous key expiry, Unix epoch milliseconds."
    }
  },
  "required": [
    "apiKey",
    "tenantId",
    "claimToken",
    "claimUrl",
    "expiresAt"
  ]
}
```

### `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"
  ]
}
```