ApiKeyBulkCreateOrUpdateBody
expiresOnstring · date-timeWhen the key expires.
descriptionstringThe description of the api key.
keystringThe API key's value. You can use this parameter to override Zuplo's default key format, but this is not recommended as you will lose our API Key Leak Detection
Zuplo.Accounts.Account
idstring · requiredThe id of the account
Example: 103f832d-5331-42db-9d38-bbac05a68305namestring · requiredThe name of the account
Example: my-account
labelstringThe label of the account
Example: My Account
Zuplo.ApiKeys.ApiKey
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · required
expiresOnstring · date-timeWhen the key expires.
descriptionstringThe description of the api key.
keystringThe API key's value. You can use this parameter to override Zuplo's default key format, but this is not recommended as you will lose our API Key Leak Detection
Zuplo.ApiKeys.ApiKeyCreateOrUpdateBody
expiresOnstring · date-timeWhen the key expires.
descriptionstringThe description of the api key.
keystringThe API key's value. You can use this parameter to override Zuplo's default key format, but this is not recommended as you will lose our API Key Leak Detection
Zuplo.ApiKeys.ApiKeys
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.ApiKeys.Bucket
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · requirednamestring · pattern:^[a-z0-9-]{5,128}$· requiredA friendly name for the bucket.
isRetrievablebooleanWhether the API keys stored in the bucket are retrievable
descriptionstringA description of the bucket.
tagsobjectKey value pairs to associate with the bucket.
Zuplo.ApiKeys.BucketCreateBody
namestring · pattern:^[a-z0-9-]{5,128}$· requiredA friendly name for the bucket.
descriptionstringA description of the bucket.
tagsobjectKey value pairs to associate with the bucket.
Zuplo.ApiKeys.BucketUpdateBody
descriptionstringA description of the bucket.
tagsobjectKey value pairs to associate with the bucket.
Zuplo.ApiKeys.Buckets
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.ApiKeys.Consumer
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · requirednamestring · pattern:^[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.
apiKeysobject[]descriptionstringA description of the consumer.
tagsobjectKey value pairs to associate with the consumer.
metadataobjectGeneric metadata associated with the consumer.
Zuplo.ApiKeys.ConsumerCreateBody
namestring · pattern:^[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.
managersEmail addresses of the managers to invite or a list of managers (with subs) to add to the consumer.
apiKeysobject[]descriptionstringA description of the consumer.
tagsobjectKey value pairs to associate with the consumer.
metadataobjectGeneric metadata associated with the consumer.
Zuplo.ApiKeys.ConsumerUpdateBody
descriptionstringA description of the consumer.
tagsobjectKey value pairs to associate with the consumer.
metadataobjectGeneric metadata associated with the consumer.
Zuplo.ApiKeys.Consumers
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.ApiKeys.ManagerCreateItem
emailstring · requiredThe email address of the manager
substring · requiredThe sub of the manager in the identity provider
Zuplo.AuditLogs.ActingAs
substring · requiredThe subject identifier of the user being impersonated
emailstring | null · requiredThe email address of the impersonated user (if available)
Zuplo.AuditLogs.Actor
substring · requiredThe subject identifier of the actor (user ID, API key, etc.)
emailstring | null · requiredThe email address of the actor (only for user actors)
typestring · requiredThe type of actor (e.g., 'user', 'consumer', 'service', 'anonymous')
connectionstring | null · requiredThe authentication connection used (e.g., 'auth0', 'google')
actingAsobject · requiredInformation about the user being impersonated, if any
metadataobject | null · requiredAdditional metadata about the actor
Zuplo.AuditLogs.AuditLog
actionstring · requiredThe action that was performed (e.g., 'account.create', 'project.delete')
metadataobject | null · requiredAdditional metadata about the action
actorobject · requiredDetails about the actor who performed the action
resourcesarray | null · requiredList of resources affected by this action
contextobject · requiredContextual information about where and how the action was performed
routeobject · requiredInformation about the API route that triggered this audit event
timestampstring · date-time · requiredThe timestamp when the action occurred
requestIdstring · requiredThe unique request ID for correlation
successboolean | null · requiredWhether the action was successful
errorstring | null · requiredError message if the action failed
Zuplo.AuditLogs.AuditLogsPagination
limitinteger · int32 · requiredMaximum number of results returned
offsetinteger · int32 · requiredNumber of results skipped
totalinteger · int32 · requiredTotal number of results available
hasMoreboolean · requiredWhether there are more results available
Zuplo.AuditLogs.AuditLogsResponse
dataobject[] · requiredArray of audit log entries
paginationobject · requiredPagination information
Zuplo.AuditLogs.Context
ipAddressstring | null · requiredThe IP address of the request
userAgentstring | null · requiredThe user agent string of the request
countrystring | null · requiredThe ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB')
regionstring | null · requiredThe region/state code (e.g., 'CA' for California)
citystring | null · requiredThe city name from which the request originated
postalCodestring | null · requiredThe postal/ZIP code
metroCodestring | null · requiredThe metro code (DMA code in the US)
asOrgstring | null · requiredThe Autonomous System organization (ISP name)
Zuplo.AuditLogs.Resource
typestring · requiredThe type of resource (e.g., 'account', 'project', 'deployment')
idstring · requiredThe unique identifier of the resource
metadataobject | null · requiredAdditional metadata about the resource
Zuplo.AuditLogs.Route
sourcestring | null · requiredThe source system or API that handled the request (e.g., 'api', 'gateway')
urlstring | null · requiredThe full URL path of the request
methodstring | null · requiredThe HTTP method used for the request
Zuplo.ClientAuth.OAuthAccessTokenResponse
access_tokenstring · requiredExample: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJz...token_typestring · enum · requiredEnum values:BearerExample: Bearerexpires_ininteger · requiredExample: 3600
scopestringExample: account project deployment
Zuplo.ClientAuth.OAuthErrorResponse
errorstring · requiredExample: invalid_clienterror_descriptionstring · requiredExample: Client authentication failed
Zuplo.Common.ExpiresOnField
expiresOnstring · date-time · requiredWhen the item will expire.
Example: 2050-04-18T05:54:34.408Z
Zuplo.Configurations.Configuration
accountNamestring · requiredExample: chocolate_great_buzzardprojectNamestring · requiredExample: lime-foxenvironmentTypestring · enum · requiredEnum values:productionpreviewdevelopmentExample: productionsystemConfigurationsstring · requiredExample: 72ih3avJtXRUz6jqHtLEBFVmJDYr1GZtMTKFS8Q71SbyiHgzbL9fPscMURcuEPnryrMv3ABU1fB4qgopG5CkmdgD2...
Zuplo.ConsumerAnalytics.CallsDetailData
consumerstring · readOnly · requiredtimeStampstring · readOnly · requiredtotalCallsinteger · readOnly · requiredcallsByStatusCodeobject[] · readOnly · required
Zuplo.ConsumerAnalytics.RequestData
consumerstring · readOnly · requiredmethodstring · readOnly · requiredroutePathstring · readOnly · requiredstatusCodestring · readOnly · requiredtimeStampstring · readOnly · requiredcitystring · readOnly · requiredcountrystring · readOnly · required
Zuplo.ConsumerAnalytics.StatsByStatusCode.TimeWindowFilter
Zuplo.ConsumerAnalytics.StatsData
totalCallsinteger · readOnly · requiredconsumerstring · readOnly · requiredcallsByStatusCodeobject[] · readOnly · required
Zuplo.DeploymentStatus.DeploymentStatus
statusstring · enum · requiredEnum values:SUCCESSERRORIN_PROGRESSExample: SUCCESSurlstring · requiredExample: https://api.zuplo.com/v1/deployments/lime-fox-main-bbe7540stepsobject · requiredbuildResultobject · required
Zuplo.Deployments.Deployment
namestring · requiredThe name of the deployment. You can find this in the Zuplo Portal under Settings > Environments.
Example: lime-fox-main-bbe7540urlstring · requiredExample: https://api.zuplo.com/deployments/lime-fox-main-bbe7540labelstring · requiredExample: mainurlParameterstring · requiredExample: maincreatedOnstring · requiredExample: 2023-07-25T23:41:41.468ZupdatedOnstring · requiredExample: 2023-07-25T23:41:41.468ZloggingIdstring · requiredExample: chocolate_great_buzzard::lime-fox::main::main::bbe7540accountNamestring · requiredExample: chocolate_great_buzzardprojectNamestring · requiredExample: lime-foxstatestring · requiredExample: STARTEDmessagestring · enum · requiredEnum values:Example:branchNamestring · requiredExample: mainenvironmentTypestring · requiredExample: PRODUCTION
Zuplo.Deploys.SourceCreateBody
accountNamestring · requiredThe name of the account
Example: my-accountprojectNamestring · requiredThe name of the project
Example: my-projectbranchNamestring · requiredThe name of the branch for deployment
Example: main
Zuplo.Deploys.SourceUrlCreateBody
accountNamestring · requiredThe name of the account
Example: my-accountprojectNamestring · requiredThe name of the project
Example: my-projectbranchNamestring · requiredThe name of the branch for deployment
Example: main
repositoryUrlstringThe git repository url of the source code
Example: https://github.com/my-account/my-projectbranchstringThe git branch
Example: mainshastringThe git sha of the commit
Example: 9fb5c38a83013be1625c9b5cb2d1bdf458ff827e
Zuplo.Environments.Environment
namestring · requiredThe name of the environment.
Example: lime-fox-main-bbe7540createdOnstring · requiredExample: 2023-07-25T23:41:41.468ZaccountNamestring · requiredExample: chocolate_great_buzzardprojectNamestring · requiredExample: lime-foxbranchNamestring · requiredExample: mainenvironmentTypestring · enum · requiredEnum values:productionpreviewdevelopmentExample: production
Zuplo.Environments.EnvironmentCreateBody
accountNamestring · requiredThe name of the account
Example: my-accountprojectNamestring · requiredThe name of the project
Example: my-projectenvironmentTypestring · enum · requiredThe name of the branch for deployment
Enum values:pruductionpreviewExample: previewbranchNamestring · requiredThe name of the branch for deployment
Example: main
Zuplo.HttpProblemDetails.BadRequestProblemResponse
typestring · enum · requiredEnum values:https://httpproblems.com/http-status/400titlestring · enum · requiredEnum values:Bad Request
detailstringinstancestring
Zuplo.HttpProblemDetails.InternalServerErrorProblemResponse
typestring · enum · requiredEnum values:https://httpproblems.com/http-status/500titlestring · enum · requiredEnum values:Internal Server Error
detailstringinstancestring
Zuplo.HttpProblemDetails.NotFoundProblemResponse
typestring · enum · requiredEnum values:https://httpproblems.com/http-status/404titlestring · enum · requiredEnum values:Not Found
detailstringinstancestring
Zuplo.HttpProblemDetails.UnauthorizedProblemResponse
typestring · enum · requiredEnum values:https://httpproblems.com/http-status/401titlestring · enum · requiredEnum values:Unauthorized
detailstringinstancestring
Zuplo.ManagedDedicated.Fleet
idstring · requiredFleet ID
namestring · requiredFleet name
vendorstring · enum · requiredFleet vendor
Enum values:akamaiamazongooglemicrosoftcontrolPlaneUrlstring · requiredControl plane URL
isAccountDefaultboolean · requiredWhether this is the default fleet for the account
createdOnstring · date-time · requiredCreation timestamp
updatedOnstring · date-time · requiredLast update timestamp
Zuplo.ManagedDedicated.FleetVendor
Fleet vendor
Zuplo.Metering.Bucket
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · requiredExample: mtr_STYBm01FabkgZOP3KtkYdJuOaccountNamestring · readOnly · requiredExample: my-account
Zuplo.Metering.Buckets
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.Metering.Plan
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · requiredExample: plan_40dRwJecUOu9xDj2OeXDcYA5hasSubscriptionsboolean · readOnly · requiredExample: truelabelstring · requiredExample: Basic Subscription PlanplanExternalIdstring · requiredExample: prod_Pbyd5ARBWtFxkgmetersobject · requiredExample: {"requests":{"label":"Requests","max":10}}
trialDaysintegerExample: 10trialEndStatusstring · enumEnum values:pausedcanceledExample: pausedisTrialCollectPaymentboolean
Zuplo.Metering.PlanCreateBody
labelstring · requiredExample: Basic Subscription PlanplanExternalIdstring · requiredExample: prod_Pbyd5ARBWtFxkgmetersobject · requiredExample: {"requests":{"label":"Requests","max":10}}
trialDaysintegerExample: 10trialEndStatusstring · enumEnum values:pausedcanceledExample: pausedisTrialCollectPaymentboolean
Zuplo.Metering.PlanUpdateBody
labelstringExample: Basic Subscription PlanplanExternalIdstringExample: prod_Pbyd5ARBWtFxkgmetersobjectExample: {"requests":{"label":"Requests","max":10}}trialDaysintegerExample: 10trialEndStatusstring · enumEnum values:pausedcanceledExample: pausedisTrialCollectPaymentboolean
Zuplo.Metering.Plans
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.Metering.Subscription
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Zidstring · readOnly · requiredExample: sbsc_BnCcCqQHM5H4z60sTR0FfCKgplanIdsstring[] · requiredExample: ["plan_ZLbXn7SCZt6KJnD6SU8Ljv8w"]planExternalIdsstring[] · requiredExample: ["prod_Pbyd5ARBWtFxkg"]statusstring · enum · requiredEnum values:activeinactiveincompleteincomplete-expiredtrialingpast-duecanceledunpaidtypestring · enum · requiredEnum values:periodicrenewalStrategystring · enum · requiredEnum values:monthlyyearlyregionstring · enum · requiredEnum values:us-central1us-east1europe-west4customerKeystring · requiredExample: d8984b34-defd-458c-bf34-7fb1b69ce714subscriptionExternalIdstring · requiredExample: sub_1OmlUlLQav6G4UBHsPy2BY7JcustomerExternalIdstring · requiredExample: cus_PbzTcoZtPtelYg
quotaResetAnchorstring · date-timemetadataobjecttrialEndStatusstringExample: pausedtrialEndDatestring · date-timetrialStartDatestring · date-timenextBillingCyclestring · date-timeproductKeystring
Zuplo.Metering.SubscriptionCreateBody
planIdsstring[] · requiredExample: ["plan_ZLbXn7SCZt6KJnD6SU8Ljv8w"]planExternalIdsstring[] · requiredExample: ["prod_Pbyd5ARBWtFxkg"]statusstring · enum · requiredEnum values:activeinactiveincompleteincomplete-expiredtrialingpast-duecanceledunpaidtypestring · enum · requiredEnum values:periodicrenewalStrategystring · enum · requiredEnum values:monthlyyearlyregionstring · enum · requiredEnum values:us-central1us-east1europe-west4customerKeystring · requiredExample: d8984b34-defd-458c-bf34-7fb1b69ce714subscriptionExternalIdstring · requiredExample: sub_1OmlUlLQav6G4UBHsPy2BY7JcustomerExternalIdstring · requiredExample: cus_PbzTcoZtPtelYg
quotaResetAnchorstring · date-timemetadataobjecttrialEndStatusstringExample: pausedtrialEndDatestring · date-timetrialStartDatestring · date-timenextBillingCyclestring · date-timeproductKeystring
Zuplo.Metering.SubscriptionUpdateBody
planExternalIdsstring[]Example: ["prod_Pbyd5ARBWtFxkg"]statusstring · enumEnum values:activeinactiveincompleteincomplete-expiredtrialingpast-duecanceledunpaidproratenumberExample: 0.75metadataobjecttrialEndDatestring · date-time
Zuplo.Metering.Subscriptions
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.MtlsCertificates.CertificateInfo
subjectstring · requiredCertificate subject
Example: CN=example.comissuerstring · requiredCertificate issuer
Example: CN=Example CAvalidFromstring · requiredCertificate valid from date
Example: 2024-01-01T00:00:00ZvalidTostring · requiredCertificate valid to date
Example: 2025-01-01T00:00:00ZserialNumberstring · requiredCertificate serial number
Example: 12345
Zuplo.MtlsCertificates.Environments
developmentboolean · requiredWhether the certificate is enabled for the development environment
previewboolean · requiredWhether the certificate is enabled for the preview environment
productionboolean · requiredWhether the certificate is enabled for the production environment
Zuplo.MtlsCertificates.MtlsCertificate
idstring · readOnly · requiredThe unique identifier for the certificate
Example: cert_abc123namestring · minLength: 1 · maxLength: 120 · requiredThe name of the certificate. Must be alphanumeric with underscores.
Example: my_client_certcertificateInfoobject · requiredCertificate information
environmentsobject · requiredEnvironments where the certificate is enabled
createdOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Z
Zuplo.MtlsCertificates.MtlsCertificateCreateBody
namestring · minLength: 1 · maxLength: 120 · requiredThe name of the certificate. Must be alphanumeric with underscores.
Example: my_client_certcertificatestring · minLength: 1 · requiredThe PEM-encoded certificate
keystring · minLength: 1 · requiredThe PEM-encoded private key
environmentsstring[] · minItems: 1 · requiredList of environments where the certificate should be enabled
Enum values:developmentpreviewproduction
Zuplo.MtlsCertificates.MtlsCertificateListResponse
dataobject[] · requiredList of mTLS certificates
offsetinteger · int32 · requiredOffset for pagination
limitinteger · int32 · requiredLimit for pagination
Zuplo.MtlsCertificates.MtlsCertificateUpdateBody
environmentsstring[] · minItems: 1List of environments where the certificate should be enabled
Enum values:developmentpreviewproduction
Zuplo.Projects.Project
namestring · requiredThe name of the project
Example: lime-foxaccountNamestring · requiredThe name of the account this project belongs to
Example: lime-fox
Zuplo.Sources.Source
uploadUrlstring · requiredExample: https://storage.googleapis.com/[..]1fac8da132b9
Zuplo.Tunnels.Tunnel
tunnelIdstring · readOnly · requiredExample: tnl_JcHFzTcJ9y4GU69lKBOaxFYUnamestring · pattern:^[a-zA-Z0-9-]{3,24}$· requiredA friendly name for the tunnel.
Example: api-service-tunneltokenstring · readOnly · requiredSet your TUNNEL_TOKEN to this value to connect to the tunnel.
Example: eyJhIjoiODJh[..]m89In0=
Zuplo.Tunnels.TunnelList
dataobject[] · required
limitinteger · uint32Example: 1000offsetinteger · uint32Example: 0totalinteger · uint32
Zuplo.Tunnels.TunnelListItem
idstring · readOnly · requiredExample: tnl_JcHFzTcJ9y4GU69lKBOaxFYUnamestring · pattern:^[a-zA-Z0-9-]{3,24}$· requiredA friendly name for the tunnel.
Example: api-service-tunnel
Zuplo.Tunnels.TunnelTeardownOperation
idstring · readOnly · requiredExample: tst_1vmvAjaCun9Mfeosn3Og4ddDstatusstring · enum · requiredEnum values:in-progresssuccesserrorExample: success
messagestringExample: Successfully torn down tunnel.detailsstring
Zuplo.Tunnels.TunneledServiceConfiguration
namestring · pattern:^[a-zA-Z0-9-]{3,24}$· requiredA friendly name for the service. This name needs to be unique across all your tunneled services. Changing this will invalidate existing services with the name.
Example: authserviceendpointstring · requiredThe URL of the service that the tunnel will forward to, e.g, http://localhost:3000
Example: https://localhost:3000configurationsobject[] · requiredA list of projects that should have access to this tunneled service under the service://name URL scheme.
Zuplo.Tunnels.TunneledServicesConfiguration
versioninteger · uint8 · requiredThe version of this configuration format.
Example: 1servicesobject[] · requiredA list of services that the tunnel will connect to.
Zuplo.Tunnels.TunneledServicesProvisioningOperation
idstring · readOnly · requiredExample: pst_ezMUOh0xFqRWg84DPH5jVwgOstatusstring · enum · requiredEnum values:in-progresssuccesserrorExample: success
messagestringExample: Successfully provisioned services.detailsstring
Zuplo.Variables.Variable
branchstring · readOnly · requiredExample: previewcreatedOnstring · date-time · readOnly · requiredWhen the item was created.
Example: 2023-04-18T05:54:34.408ZupdatedOnstring · date-time · readOnly · requiredWhen the item was last updated.
Example: 2023-04-20T05:54:34.408Znamestring · requiredThe name of the variable. Must be named in SCREAMING_SNAKE_CASE.
Example: APP_ENVIRONMENT_KEYisSecretboolean · requiredWhether the variable is a secret.
Example: truevaluestring · requiredThe value of the variable.