API Key 作成

POST

/dashboard/api-keys

• Staging
• Production (planned)

キー本体は作成時のレスポンスでのみ返される。再取得不可。 キーは mk_ プレフィクス + 64 hex 文字。保存時は SHA-256 ハッシュ化。 sudoGuard 必須: X-Sudo-Token ヘッダーが必要。未提供または期限切れの場合は 403 SUDO_REQUIRED を返す。

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Sudo-Token

required

string

Sudo セッショントークン (POST /dashboard/sudo/verify で取得)

Request Body ^required

object

name

required

string

<= 100 characters

scopes

Array<string>

default: read

Allowed values: read write

type

キーの種類。session は Dashboard からは作成不可 (Device Auth 専用)

string

default: persistent

Allowed values: persistent expiring

expiresAt

有効期限 (type=expiring 時のみ必須、未来かつ1年以内)

string format: date-time

Responses

201

作成成功 (キー本体を含む)

object

apiKey

object

id

string

name

string

key

フルキー (この1回のみ表示)

string

Example

mk_1fcb3e760b18c50a003e1d57c6f4f22265fc29ee4e0d5266858da54bd9696b9a

keyPrefix

string

scopes

Array<string>

type

string

Allowed values: persistent expiring

expiresAt

string

nullable

403

Sudo トークン未提供または期限切れ (SUDO_REQUIRED)

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing