Command: issue an administrative key with fine-grained scopes over the four admin levels (admin only; session only).

POST

/admin/api-keys/create

curl --request POST \
  --url https://example.com/api/v1/admin/api-keys/create \
  --header 'Content-Type: application/json' \
  --cookie dnse_session=<dnse_session> \
  --data '{ "name": "example", "scopes": [ "users" ], "expiresAt": "example" }'

Authorizations

• session

Request Body^required

Media typeapplication/json

object

name

required

string

scopes

required

Array<string>

Allowed values: users teams projects settings

expiresAt

RFC 3339 or YYYY-MM-DD; empty = 1 year.

string

Responses

201

Key created; secret shows exactly once.

Media typeapplication/json

object

id

string format: uuid

name

string

kind

string

Allowed values: project admin

projectId

string format: uuid

projectName

Resolved in the admin overview.

string

role

string

Allowed values: manager editor visitor

scopes

Array<string>

Allowed values: users teams projects settings

expiresAt

string format: date-time

lastUsedAt

string format: date-time

secret

Present only in the create response — shown exactly once.

string

Example

{
  "kind": "project",
  "role": "manager",
  "scopes": [
    "users"
  ]
}

400

Malformed request.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}