ZuploZuplo
LoginSign Up
  • Documentation
  • API Reference
Information
Analytics
    Get recent requests for a given deployment in the last 24 hoursgetGet statistics on requests by status code for a given deploymentget
API Keys - Buckets
    Lists bucketsgetCreates a bucketpostGets a bucketgetDeletes a bucketdeleteUpdates a bucketpatch
API Keys - Consumers
    Lists consumersgetCreates a consumerpostGets a consumergetDeletes a consumerdeleteUpdates a consumerpatchRoll consumer keyspost
API Keys - Keys
    Lists keysgetCreates an API keypostCreates multiple API keyspostGets an API keygetDeletes an API keydeleteUpdates an API keypatch
API Keys - Managers
    Lists managersgetCreates a managerpostDeletes a managerdelete
Audit Logs
    Query audit logsget
Build Logs
    Get build logsget
Client mTLS CA Certificates
    List Client mTLS CA CertificatesgetCreate Client mTLS CA CertificatepostDelete Client mTLS CA CertificatedeleteUpdate Client mTLS CA Certificatepatch
Custom Domains
    Get Custom DomainsgetCreate Custom DomainpostDelete a Custom DomaindeleteUpdate a Custom Domainpatch
Deployments
    Gets a deployment statusgetLists deploymentsgetUpload deployment sourcepostGet a deploymentgetDeletes a deploymentdeleteRe-deploy a deploymentpost
Environments
    Query environmentsgetGet an environmentget
MCP Servers
    API MCP ServerpostDocs MCP Serverpost
Metering - Features
    List featuresgetCreate featurepostGet featuregetDelete featuredelete
Metering - Meters
    List metersgetCreate meterpostGet metergetUpdate meterputDelete meterdeleteList meter group by valuesgetQuery metergetQuery meterpost
Metering - Plans
    List plansgetCreate a planpostGet plangetUpdate a planputDelete plandeleteArchive plan versionpostPublish planpost
Projects
    Create projectpost
Runtime Logs
    List request logsgetGet request log detailget
Tunnel Services
    Gets a provisioning statusgetGets a service configurationgetConfigures tunnel servicesput
Tunnels
    Lists tunnelsgetCreates a tunnelpostGets a tunnelgetDeletes a tunneldeleteRotates the tokenpostGets a teardown statusget
Variables
    Creates a variablepostUpdates a variablepatch
Other endpoints
    OpenAPI SpecificationgetLists accountsgetLists projectsgetWho Am Iget
Schemas
powered by Zudoku
Zuplo Developer API
Zuplo Developer API

API Keys - Buckets

A Bucket is an object representing a group of API key consumers for a given account. This section includes a group of endpoints available to perform CRUD operations on a bucket. You can learn more about buckets here.


Lists buckets

GET
https://dev.zuplo.com
/v1/accounts/{accountName}/key-buckets

Lists all buckets belonging to this account.

Lists buckets › path Parameters

accountName
​string · required

The name of the account. You can find this in your Zuplo Portal under Settings > Project Information.

Lists buckets › Responses

The request has succeeded.

Zuplo.ApiKeys.Buckets
​Zuplo.ApiKeys.Bucket[] · required
limit
​integer · uint32
offset
​integer · uint32
total
​integer · uint32
GET/v1/accounts/{accountName}/key-buckets
curl https://dev.zuplo.com/v1/accounts/:accountName/key-buckets
Example Responses
{ "data": [ { "id": "bckt_pCcNMjERFSoh5xIQir7o99Z6KDoLp36e", "name": "my-bucket", "createdOn": "2023-07-24T19:26:36.000Z", "updatedOn": "2023-07-24T19:26:36.000Z", "description": "Bucket for zuplo consumers", "isRetrievable": true, "tags": { "foo": "bar" } } ] }
json
application/json

Creates a bucket

POST
https://dev.zuplo.com
/v1/accounts/{accountName}/key-buckets

Creates a new bucket for this account.

Creates a bucket › path Parameters

accountName
​string · required

The name of the account. You can find this in your Zuplo Portal under Settings > Project Information.

Creates a bucket › Request Body

Zuplo.ApiKeys.BucketCreateBody
name
​string · pattern: ^[a-z0-9-]{5,128}$ · required

A friendly name for the bucket.

description
​string

A description of the bucket.

​object

Key value pairs to associate with the bucket.

Creates a bucket › Responses

The request has succeeded.

Top level group for API key mangement. A bucket could be used with a single Zuplo environment or shared among multiple environments or projects. By default a Zuplo API Gateway project will be created with several buckets that map to production, preview, and working copy environments.
Zuplo.ApiKeys.Bucket
createdOn
​string · date-time · readOnly · required

When the item was created.

Example: 2023-04-18T05:54:34.408Z
updatedOn
​string · date-time · readOnly · required

When the item was last updated.

Example: 2023-04-20T05:54:34.408Z
id
​string · readOnly · required
name
​string · pattern: ^[a-z0-9-]{5,128}$ · required

A friendly name for the bucket.

isRetrievable
​boolean

Whether the API keys stored in the bucket are retrievable

description
​string

A description of the bucket.

​object

Key value pairs to associate with the bucket.

POST/v1/accounts/{accountName}/key-buckets
curl https://dev.zuplo.com/v1/accounts/:accountName/key-buckets \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "name": "my-bucket", "description": "Bucket for zuplo consumers", "tags": { "foo": "bar" } }'
Example Request Body
{ "name": "my-bucket", "description": "Bucket for zuplo consumers", "tags": { "foo": "bar" } }
json
Example Responses
{ "id": "bckt_pCcNMjERFSoh5xIQir7o99Z6KDoLp36e", "name": "my-bucket", "createdOn": "2023-07-24T19:26:36.000Z", "updatedOn": "2023-07-24T19:26:36.000Z", "description": "Bucket for zuplo consumers", "isRetrievable": true, "tags": { "foo": "bar" } }
json
application/json

Gets a bucket

GET
https://dev.zuplo.com
/v1/accounts/{accountName}/key-buckets/{bucketName}

Returns the details for a bucket, including the token used to connect to the bucket.

Gets a bucket › path Parameters

accountName
​string · required

The name of the account. You can find this in your Zuplo Portal under Settings > Project Information.

bucketName
​string · required

The name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.

Gets a bucket › Responses

The request has succeeded.

Top level group for API key mangement. A bucket could be used with a single Zuplo environment or shared among multiple environments or projects. By default a Zuplo API Gateway project will be created with several buckets that map to production, preview, and working copy environments.
Zuplo.ApiKeys.Bucket
createdOn
​string · date-time · readOnly · required

When the item was created.

Example: 2023-04-18T05:54:34.408Z
updatedOn
​string · date-time · readOnly · required

When the item was last updated.

Example: 2023-04-20T05:54:34.408Z
id
​string · readOnly · required
name
​string · pattern: ^[a-z0-9-]{5,128}$ · required

A friendly name for the bucket.

isRetrievable
​boolean

Whether the API keys stored in the bucket are retrievable

description
​string

A description of the bucket.

​object

Key value pairs to associate with the bucket.

GET/v1/accounts/{accountName}/key-buckets/{bucketName}
curl https://dev.zuplo.com/v1/accounts/:accountName/key-buckets/:bucketName
Example Responses
{ "id": "bckt_pCcNMjERFSoh5xIQir7o99Z6KDoLp36e", "name": "my-bucket", "createdOn": "2023-07-24T19:26:36.000Z", "updatedOn": "2023-07-24T19:26:36.000Z", "description": "Bucket for zuplo consumers", "isRetrievable": true, "tags": { "foo": "bar" } }
json
application/json

Deletes a bucket

DELETE
https://dev.zuplo.com
/v1/accounts/{accountName}/key-buckets/{bucketName}

Deletes a bucket and any related resources

Deletes a bucket › path Parameters

accountName
​string · required

The name of the account. You can find this in your Zuplo Portal under Settings > Project Information.

bucketName
​string · required

The name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.

Deletes a bucket › Responses

There is no content to send for this request, but the headers may be useful.

No data returned
DELETE/v1/accounts/{accountName}/key-buckets/{bucketName}
curl https://dev.zuplo.com/v1/accounts/:accountName/key-buckets/:bucketName \ --request DELETE
Example Responses
No example specified for this content type

Updates a bucket

PATCH
https://dev.zuplo.com
/v1/accounts/{accountName}/key-buckets/{bucketName}

Updates a bucket, and returns the updated value.

Updates a bucket › path Parameters

accountName
​string · required

The name of the account. You can find this in your Zuplo Portal under Settings > Project Information.

bucketName
​string · required

The name of the bucket. Zuplo automatically creates a bucket for your project. You can find it in youe Zuplo Portal under Settings > Project Information.

Updates a bucket › Request Body

Zuplo.ApiKeys.BucketUpdateBody
description
​string

A description of the bucket.

​object

Key value pairs to associate with the bucket.

Updates a bucket › Responses

The request has succeeded.

Top level group for API key mangement. A bucket could be used with a single Zuplo environment or shared among multiple environments or projects. By default a Zuplo API Gateway project will be created with several buckets that map to production, preview, and working copy environments.
Zuplo.ApiKeys.Bucket
createdOn
​string · date-time · readOnly · required

When the item was created.

Example: 2023-04-18T05:54:34.408Z
updatedOn
​string · date-time · readOnly · required

When the item was last updated.

Example: 2023-04-20T05:54:34.408Z
id
​string · readOnly · required
name
​string · pattern: ^[a-z0-9-]{5,128}$ · required

A friendly name for the bucket.

isRetrievable
​boolean

Whether the API keys stored in the bucket are retrievable

description
​string

A description of the bucket.

​object

Key value pairs to associate with the bucket.

PATCH/v1/accounts/{accountName}/key-buckets/{bucketName}
curl https://dev.zuplo.com/v1/accounts/:accountName/key-buckets/:bucketName \ --request PATCH \ --header 'Content-Type: application/json' \ --data '{ "description": "Bucket for zuplo consumers", "tags": { "foo": "bar" } }'
Example Request Body
{ "description": "Bucket for zuplo consumers", "tags": { "foo": "bar" } }
json
Example Responses
{ "id": "bckt_pCcNMjERFSoh5xIQir7o99Z6KDoLp36e", "name": "my-bucket", "createdOn": "2023-07-24T19:26:36.000Z", "updatedOn": "2023-07-24T19:26:36.000Z", "description": "Bucket for zuplo consumers", "isRetrievable": true, "tags": { "foo": "bar" } }
json
application/json

AnalyticsAPI Keys - Consumers