Upsert an API key

Request

Create or update (upsert) API key with a specified ID.

Security
SecretApiKey or JWT
Path
idstring, <= 50 characters^[@~\-\.\w]+$required
ID of the resource.
Bodyapplication/jsonrequired
ApiKey resource.
descriptionstringrequired
API key description.
typestring
Type of API key.
Default:"secret"
Enum:"secret""publishable"
aclArray of objects(Acl)
Permissions for this API key. A request is authorized only when these permissions include the permission for the operation, and the associated user has that permission. If these permissions include `*`, each operation is limited to the permissions of the associated user. If the associated user loses a permission and these permissions still include that permission, a request that requires that permission is not authorized. If the associated user gains a permission, a request that requires that permission is authorized only when these permissions include that permission or `*`. For more information, see [Ownership of an API key](https://www.rebilly.com/docs/dev-docs/api-keys/#ownership-of-an-api-key). Permissions in a `scope` with no `organizationId` value apply in all organizations of the associated user. These permissions are accepted only when the API key or JWT that authenticates the request has them with no organization limit.
allowedIpsArray of strings or null, (ip)(AllowedIps)

List of IP addresses that are permitted access. Private subnets are prohibited. To remove restrictions, set this value to null.

Example:
[ "153.12.32.33", "201.54.122.0/24", "2001:0db8:abcd:0012:0000:0000:0000:ffff", "2001:db8:abcd:12::0/64" ]
expirationTimestring or null, (date-time)

Date and time when the API key expires. From this time, a request that uses the API key gets a 401 response. If this value is not in the future, a validation error is returned. To remove the expiration, set this property to null. If an update request omits this property, the expiration time is not changed. This value is null if the API key does not expire.

curl -i -X PUT \
  'https://www.rebilly.com/_mock/catalog/all/api-keys/{id}' \
  -H 'Content-Type: application/json' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE' \
  -d '{
    "description": "string",
    "type": "secret",
    "acl": [
      {
        "scope": {
          "organizationId": [
            "organizationId-id-1"
          ]
        },
        "permissions": [
          "PostFile",
          "StorefrontGetAccount",
          "StorefrontGetWebsite",
          "StorefrontGetKycDocument",
          "StorefrontPostKycDocument"
        ]
      }
    ],
    "allowedIps": [
      "153.12.32.33",
      "201.54.122.0/24",
      "2001:0db8:abcd:0012:0000:0000:0000:ffff",
      "2001:db8:abcd:12::0/64"
    ],
    "expirationTime": "2019-08-24T14:15:22Z"
  }'

Responses

API key updated.
Bodyapplication/json
idstring, <= 50 charactersread-only
ID of the API key.
Example:"api_key_0YV7JQMY6ED2FBE58BMFHBWBZH"
descriptionstringrequired
API key description.
typestring
Type of API key.
Default:"secret"
Enum:"secret""publishable"
aclArray of objects(Acl)
Permissions for this API key. A request is authorized only when these permissions include the permission for the operation, and the associated user has that permission. If these permissions include `*`, each operation is limited to the permissions of the associated user. If the associated user loses a permission and these permissions still include that permission, a request that requires that permission is not authorized. If the associated user gains a permission, a request that requires that permission is authorized only when these permissions include that permission or `*`. For more information, see [Ownership of an API key](https://www.rebilly.com/docs/dev-docs/api-keys/#ownership-of-an-api-key). Permissions in a `scope` with no `organizationId` value apply in all organizations of the associated user. These permissions are accepted only when the API key or JWT that authenticates the request has them with no organization limit.
allowedIpsArray of strings or null, (ip)(AllowedIps)

List of IP addresses that are permitted access. Private subnets are prohibited. To remove restrictions, set this value to null.

Example:
[ "153.12.32.33", "201.54.122.0/24", "2001:0db8:abcd:0012:0000:0000:0000:ffff", "2001:db8:abcd:12::0/64" ]
lastUsedTimestring or null, (date-time)read-only

Date and time when the API key last authenticated a request. This value is updated at most once every 5 minutes. This value is null if the API key has no recorded use.

lastUsedIpstring or null, (ip)read-only

IP address of the request that last updated lastUsedTime. This value is null if the API key has no recorded use.

expirationTimestring or null, (date-time)

Date and time when the API key expires. From this time, a request that uses the API key gets a 401 response. If this value is not in the future, a validation error is returned. To remove the expiration, set this property to null. If an update request omits this property, the expiration time is not changed. This value is null if the API key does not expire.

apiUserstringread-only
API user name.
secretKeystringread-only

Value of the API secret key. For a secret key, the full value is returned only in the response to the request that creates the key. Other responses return a masked value that keeps only the prefix and the apiUser value. For a publishable key, every response returns the full value.

createdTimestring, (date-time)(CreatedTime)read-only
Date and time when the resource is created. This value is set automatically when the resource is created.
updatedTimestring, (date-time)(UpdatedTime)read-only
Date and time when the resource is updated. This value is set automatically when the resource is updated.
Response
{ "id": "api_key_0YV7JQMY6ED2FBE58BMFHBWBZH", "description": "string", "type": "secret", "acl": [ { … } ], "allowedIps": [ "153.12.32.33", "201.54.122.0/24", "2001:0db8:abcd:0012:0000:0000:0000:ffff", "2001:db8:abcd:12::0/64" ], "lastUsedTime": "2019-08-24T14:15:22Z", "lastUsedIp": "string", "expirationTime": "2019-08-24T14:15:22Z", "apiUser": "string", "secretKey": "string", "createdTime": "2019-08-24T14:15:22Z", "updatedTime": "2019-08-24T14:15:22Z", "_links": [ { … } ] }