fetchOrCreateP256ApiKeyUser()

Fetches an existing user by P-256 API key public key, or creates a new one if none exists.

This function is idempotent: multiple calls with the same publicKey will always return the same user.
Attempts to find a user whose API keys include the given P-256 public key.
If a matching user is found, it is returned as-is.
If no matching user is found, a new user is created with the given public key as a P-256 API key.

Package: core

Defined in: core.ts:2460

params

object

required

Show params details

params.createParams

object

Show createParams details

params.createParams.apiKeyName

string

optional API key name to assign if creating a new API key (defaults to public-key-user-${publicKey}).

params.createParams.userName

string

optional username to assign if creating a new user (defaults to "Public Key User").

params.publicKey

string

required

the P-256 public key to use for lookup and creation.

A successful response returns the following fields:

returns

v1User

required

A promise that resolves to the existing or newly created v1User.

⌘I