---
title: "Get a free API key instantly — zero friction"
method: POST
path: "/v5/keys/instant"
---

# Get a free API key instantly — zero friction

`POST /v5/keys/instant`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/keys/instant`
- Auth: none declared

Returns a free-tier API key immediately. No email, no signup. One key per agent_id (idempotent). Rate-limited to 10 keys per IP per day. Designed for autonomous agents to self-provision.

## Request body

- object
  - `agent_id` string, required: Unique identifier for the agent (any string, max 256 chars)

## Response `200`

API key issued or existing key returned

- object
  - `api_key` string
  - `daily_limit` integer
  - `plan` string
  - `usage` string
  - `example` string
  - `upgrade_url` string

## Other responses

- `400`: Invalid or missing agent_id
- `429`: Rate limited — max 10 instant keys per day per IP

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)