---
title: "Provision a free-tier API key"
method: POST
path: "/auth/provision-free"
tags: ["Authentication"]
---

# Provision a free-tier API key

`POST /auth/provision-free`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/auth/provision-free`
- Auth: HTTP bearer

Generate a free API key with limited daily usage (100 req/day, 10 req/min). No payment or email required. Returns the key once — store it immediately.

## Request body

- object
  - `agent_name` string, required: Display name for the free-tier agent (≥ 3 characters).
  - `purpose` string: Optional description of intended use.

## Response `201`

Free API key created.

- object
  - `account` object
    - `user_id` string
    - `agent_name` string
    - `tier` 'free'
    - `limits` object
      - `queries_per_day` integer
      - `queries_per_minute` integer
  - `credentials` object
    - `api_key` string: Shown only once. Store securely.
    - `prefix` string

## Other responses

- `400`: Invalid agent_name.

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)