A Consumer is an object representing a group of API keys in a given bucket. This section includes a group of endpoints available to perform CRUD operations on a consumer. You can learn more about consumers here.
Lists consumers
Lists all consumers belonging to this account.
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
query Parameters
limitThe maximum number of entries to return. If the value exceeds the maximum, then the maximum value will be used. Default: 1000
offsetThe offset of the first item returned in the collection. Default: 0
include-api-keysInclude the api key data in the response.
include-manager-invitesInclude the manager invites data in the response.
include-managersInclude the manager's data in the response.
key-formatThe format of the key to return.
none: Key is completely hidden.
visible: Key is completely visible.
masked: Part of key suffix is visible.
manager-emailFilter by email address of key manager.
tagQuery by tag. Example usage is tag.account=foo, where account is the name of the tag property and foo is the value.
Responses
The request has succeeded.
limitoffsettotalCreates a consumer
Creates a new consumer for this account.
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
query Parameters
with-api-keyIf an API key should be created with the consumer.
Request Body
name^[a-z0-9-]{1,128}$ · requiredA friendly name for the consumer. This name is used as the default user.sub property in the API Key Authentication policy.
Email addresses of the managers to invite or a list of managers (with subs) to add to the consumer.
descriptionA description of the consumer.
Key value pairs to associate with the consumer.
Generic metadata associated with the consumer.
Responses
The request has succeeded.
createdOnWhen the item was created.
updatedOnWhen the item was last updated.
idname^[a-z0-9-]{1,128}$ · requiredA friendly name for the consumer. This name is used as the default user.sub property in the API Key Authentication policy.
descriptionA description of the consumer.
Key value pairs to associate with the consumer.
Generic metadata associated with the consumer.
Gets a consumer
Gets a consumer given a bucket name and consumer name.
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
consumerNameThe name of the consumer.
query Parameters
include-api-keysInclude the api key data in the response.
key-formatThe format of the key to return.
none: Key is completely hidden.
visible: Key is completely visible.
masked: Part of key suffix is visible.
include-managersInclude the manager's data in the response.
include-manager-invitesInclude the manager invites data in the response.
tagQuery by tag. Example usage is tag.account=foo, where account is the name of the tag property and foo is the value.
Responses
The request has succeeded.
createdOnWhen the item was created.
updatedOnWhen the item was last updated.
idname^[a-z0-9-]{1,128}$ · requiredA friendly name for the consumer. This name is used as the default user.sub property in the API Key Authentication policy.
descriptionA description of the consumer.
Key value pairs to associate with the consumer.
Generic metadata associated with the consumer.
Deletes a consumer
Deletes a consumer and any related resources
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
consumerNameThe name of the consumer.
query Parameters
tagQuery by tag. Example usage is tag.account=foo, where account is the name of the tag property and foo is the value.
Responses
There is no content to send for this request, but the headers may be useful.
Updates a consumer
Update the consumer with the matching consumer name.
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
consumerNameThe name of the consumer.
query Parameters
tagQuery by tag. Example usage is tag.account=foo, where account is the name of the tag property and foo is the value.
Request Body
descriptionA description of the consumer.
Key value pairs to associate with the consumer.
Generic metadata associated with the consumer.
Responses
The request has succeeded.
createdOnWhen the item was created.
updatedOnWhen the item was last updated.
idname^[a-z0-9-]{1,128}$ · requiredA friendly name for the consumer. This name is used as the default user.sub property in the API Key Authentication policy.
descriptionA description of the consumer.
Key value pairs to associate with the consumer.
Generic metadata associated with the consumer.
Roll consumer keys
Set expiration for keys with no expiration date and creates a new key.
path Parameters
accountNameThe name of the account. You can find this in your Zuplo Portal under Settings > Project Information.
bucketNameThe name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.
consumerNameThe name of the consumer.
query Parameters
tagQuery by tag. Example usage is tag.account=foo, where account is the name of the tag property and foo is the value.
Request Body
expiresOnWhen the item will expire.
Responses
There is no content to send for this request, but the headers may be useful.