b2_create_keyCreates a new application key. There is a limit of 100 million key creations per account. RequestRequest HTTP HeadersAuthorization required
An account authorization token, obtained from
Request HTTP Message Body ParametersaccountId required Your account ID. capabilities required
A list of strings, each one naming a capability the new key should have.
Possibilities are:
keyName required A name for this key. There is no requirement that the name be unique. The name cannot be used to look up the key. Names can contain letters, numbers, and "-", and are limited to 100 characters. validDurationInSeconds optional
When provided, the key will expire after the given number of seconds, and
will have bucketId optional
When present, the new key can only access this bucket. When set, only
these capabilities can be specified:
namePrefix optional
When present, restricts access to files whose names start with the prefix.
You must set ResponseResponse HTTP Status 200Bucket successfully created. The JSON response will contain: keyName required The name assigned when the key was created. applicationKeyId required The ID of the newly created key. applicationKey required The secret part of the key. This is the only time it will be returned, so you need to keep it. This is not returned when you list the keys in your account. capabilities required
A list of strings, each one naming a capability the key has.
Possibilities are:
accountId required The account that this application key is for. expirationTimestamp optional When present, says when this key will expire, in milliseconds since 1970. bucketId optional When present, restricts access to one bucket. namePrefix optional When present, restricts access to files whose names start with the prefix Response Errors
Bucket not created.
If possible the server will return a JSON error structure. Errors include:
|