Skip to main content
POST
Create

Authorizations

korve.session_token
string
cookie
required

Path Parameters

orgId
string
required

The organization's id (UUID) or slug — either form is accepted.

Body

application/json
name
string
required

Display name, 1-100 characters.

Pattern: ^.{1,100}$
role
enum<string>

Role ceiling the key authenticates with. Defaults to "admin"; never owner.

Available options:
member,
admin

Response

API key created. key is the full secret — shown exactly once; store it securely.

id
string
required
name
string
required
keyPrefix
string
required

Display handle for the key, e.g. "korve_ab12…". Never the secret.

role
enum<string>
required

Role ceiling the key authenticates with. Defaults to "admin"; never owner.

Available options:
member,
admin
key
string
required

The full secret. Shown exactly once — it is never retrievable later.

Pattern: ^korve_[0-9a-f]{40}$