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

Runtime Logs


List request logs

GET
https://dev.zuplo.com
/v1/deployments/{deploymentName}/logs/requests

Lists request-log summaries for a deployment within the given time window, ordered most recent first. Supports cursor pagination and optional filtering by HTTP method, status class, route path, log severity, and free-text search.

List request logs › path Parameters

deploymentName
​string · required

The name of the deployment. You can find this in the Zuplo Portal under Settings > Environments.

List request logs › query Parameters

startTime
​string · date-time · required

Inclusive ISO 8601 lower bound on request timestamp.

endTime
​string · date-time · required

Inclusive ISO 8601 upper bound on request timestamp.

cursor
​string

Opaque cursor returned in pagination.cursor on a previous page. Pass to fetch the next page.

limit
​integer · int32 · min: 1 · max: 200

Maximum number of results to return (1-200).

Default: 50
httpMethod
​string · enum

Filter to requests with this HTTP method.

Enum values:
GET
POST
PUT
PATCH
DELETE
HEAD
OPTIONS
TRACE
httpStatus
​string · enum

Filter to requests with this HTTP status class (2xx, 3xx, 4xx, 5xx).

Enum values:
2xx
3xx
4xx
5xx
routePath
​string

Filter to requests that matched this route path.

search
​string

Case-insensitive free-text search across log message bodies for the request window.

severity
​string · enum

Filter to requests whose maximum log severity equals this value.

Enum values:
debug
info
warn
error

List request logs › Responses

The request has succeeded.

Response listing request-log summaries for a deployment.
Zuplo.RuntimeLogs.RequestLogsListResponse
​Zuplo.RuntimeLogs.RequestLogSummary[] · required

Array of request-log summaries, ordered most recent first.

​object · required

Pagination state for the result set.

GET/v1/deployments/{deploymentName}/logs/requests
curl 'https://dev.zuplo.com/v1/deployments/:deploymentName/logs/requests?startTime=<string>&endTime=<string>'
Example Responses
{ "data": [ { "requestId": "c21fefe0-8938-4f17-8fb8-c844d68042f3", "timestamp": "2026-05-14T12:00:00.000Z", "httpMethod": "GET", "httpStatus": 200, "routePath": "/v1/items/:id", "durationMs": 42, "colo": "SFO", "country": "US", "maxSeverity": "info", "logCount": 3 } ], "pagination": { "cursor": null, "hasMore": false } }
json
application/json

Get request log detail

GET
https://dev.zuplo.com
/v1/deployments/{deploymentName}/logs/requests/{requestId}

Retrieves the full request detail and all log entries for a single request on a deployment.

Get request log detail › path Parameters

deploymentName
​string · required

The name of the deployment. You can find this in the Zuplo Portal under Settings > Environments.

requestId
​string · required

The unique identifier of the request (correlation ID stamped by the gateway).

Get request log detail › Responses

The request has succeeded.

Response containing the request detail and all log entries for a single request.
Zuplo.RuntimeLogs.RequestLogDetailResponse
​object · required

The request summary and contextual fields.

​Zuplo.RuntimeLogs.RequestLogEntry[] · required

All log entries emitted during the request, ordered by emit time.

GET/v1/deployments/{deploymentName}/logs/requests/{requestId}
curl https://dev.zuplo.com/v1/deployments/:deploymentName/logs/requests/:requestId
Example Responses
{ "request": { "requestId": "requestId", "timestamp": "2024-08-25T15:00:00Z", "httpMethod": "httpMethod", "httpStatus": 0, "routePath": "routePath", "durationMs": 0, "colo": "colo", "country": "country", "city": "city", "continent": "continent", "clientIp": "clientIp", "asOrganization": "asOrganization", "userSub": "userSub", "systemRouteName": "systemRouteName", "zuploUserAgent": "zuploUserAgent" }, "logs": [ { "logId": "logId", "timestamp": "2024-08-25T15:00:00Z", "severity": "severity", "messages": [ "string" ], "attributes": { "key": "string" }, "source": "source", "requestId": "requestId", "atomicCounter": 0 } ] }
json
application/json

ProjectsTunnel Services