---
title: "Create gateway key"
method: POST
path: "/api/v1/gateway/keys"
tags: ["Keys"]
---

# Create gateway key

`POST /api/v1/gateway/keys`

## Request

- Base URL: `http://dobby-ai.com`
- URL: `http://dobby-ai.com/api/v1/gateway/keys`
- Auth: HTTP bearer

Create a new gateway API key. The full secret is only returned once.

## Request body

- CreateKeyRequest
  - `key_type` 'user' | 'service' | 'temporary', required
  - `display_name` string, required
  - `scopes` string[]
  - `rate_limit_rpm` integer
  - `expires_in_days` integer
  - `service_name` string: Required for service keys

## Response `200`

Key created (secret shown once)

- object
  - `key` GatewayKey
    - `id` string
    - `key_prefix` string
    - `key_type` 'user' | 'service' | 'temporary'
    - `display_name` string
    - `scopes` string[]
    - `rate_limit_rpm` integer
    - `is_active` boolean
    - `last_used_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time
  - `secret` string: Full key secret — only returned once

---

[API](https://skmtc.dev/dobby-ai/apis/dobby-gateway-api.md) · [All operations](https://skmtc.dev/dobby-ai/apis/dobby-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dobby-ai/apis/dobby-gateway-api/revisions/c189542f9647?raw)