v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-224341,4072.0 MB
Personal Client

Create

Create creates a new PersonalClient object for the current User.

post/api/v1/iam/personal_clients

Request body

allowSourceCidrstring[] nullable

A list of CIDRs to restrict this credential to. Accepts IPv4 (e.g. 10.0.0.0/24) or IPv6 (e.g. 2001:db8::/32) CIDRs.

displayNamestring

The display name for the new personal client.

expiresstring duration
scopedRolesstring[] nullable

The list of roles to restrict the credential to.

Response

The PersonalClientServiceCreateResponse message contains the created personal client and client secret.

clientSecretstring

The client secret that corresponds to the personal client. Make sure to save this, because it cannot be returned or queried again.