---
title: "Generate New Api Key"
method: POST
path: "/api/v1/tiers/api-key/generate"
tags: ["API Tiers"]
---

# Generate New Api Key

`POST /api/v1/tiers/api-key/generate`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/tiers/api-key/generate`
- Auth: HTTP bearer

Generate a new API key

## Cookies

- `access_token` string, nullable

## Request body

- ApiKeyGenerate: Schema for generating API key
  - `name` string, nullable: Optional name for the key

## Response `201`

Successful Response

- AppSchemasApiTierApiKeyResponse: Schema for API key response
  - `id` integer, required
  - `api_key` string, nullable: Full key only shown once on creation
  - `key_preview` string, required: Format: sk_test...abcd
  - `name` string, nullable, required
  - `status` string: Key status: active, revoked, or expired
  - `created_at` string, date-time, required
  - `last_used_at` string, date-time, nullable, required
  - `usage_count` integer, required
  - `is_active` boolean, required
  - `expires_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)