Skip to main content
Creates an API key and returns its full value exactly once — save it immediately; read endpoints never return it again. The new key carries the same authority as the key that created it, unless you issue it for a virtual member with a narrower role.
Permission required: service_account:create

Headers

string
Optional. Retrying with the same value replays the first result instead of creating a second key.

Request Body

string
required
Display name (1–100 characters)
integer
Expiry, Unix seconds. Omit or send 0 for a key that never expires.
string
Issue the key for a virtual member; the key then acts as that member, with its role and attribution. Only virtual members can be targeted — human members return 404. Requires member:manage_virtual in addition to service_account:create.

Response

object