Skip to main content

IssueMyKey

POST 
/v1/me/keys

IssueMyKey issues a new long-lived API key for the caller. The secret field in the response is returned exactly once and cannot be retrieved again. Store it in a secrets manager immediately.

Issuing a management key (type API_KEY_TYPE_MANAGEMENT) requires the api_keys.create permission for the target customer -- the built-in Super Admin and User Admin roles carry it -- or the request fails with PERMISSION_DENIED. Inference keys (the default) are open to any authenticated session.

The key carries the caller's own access, not the organization's: a caller who cannot already administer the customer receives read-only management scopes, and asking for broader ones fails with PERMISSION_DENIED.

Request​

Responses​

Success