Command: issue a project key with a project role (requires manager; session only). The secret is present only in THIS response; expiry max. 2 years.

POST

/projects/{projectId}/api-keys/create

curl --request POST \
  --url https://example.com/api/v1/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/api-keys/create \
  --header 'Content-Type: application/json' \
  --cookie dnse_session=<dnse_session> \
  --data '{ "name": "example", "role": "manager", "expiresAt": "example" }'

Authorizations

• session

Parameters

Path Parameters

projectId

required

string format: uuid

Request Body^required

Media typeapplication/json

object

name

required

string

role

required

string

Allowed values: manager editor visitor

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"
}