Create API Key

Required role: write or higher.

Create a new API key with the specified name. The generated API key will be returned in the response and cannot be retrieved again later.

Request Body — REQUIRED
name string — REQUIRED Key name.
role string Possible values: [read, write] The role an API key carries: read or write. API keys cannot be granted admin or owner; those roles are held only by interactive logins and OIDC trust relationships.

Responses
201 API key created successfully Schema — OPTIONAL api_key string Generated secret API key. There is no way to retrieve this key again through the API, so store it securely. id uuid API key identifier. name string API key name provided by the user.
409 API key with that name already exists Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.