Serverless Containers

Get deployment replica logs

Fetch log lines from the replicas of a deployment.

get/v1/container-deployments/{deployment_name}/logs

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/container-deployments/{deployment_name}/logs
  • Auth: HTTP bearer

Path parameters

deployment_namestring required
Example:my-deployment

Name of the deployment

Query parameters

container_namestring
Example:app

Filter by container name. If omitted, the endpoint returns the logs of all user containers of the deployment. A name that is not a container of this deployment returns no log lines.

podstring[]

Filter by replica (pod) name. Repeat the parameter for multiple values.

search_textstring
Example:error

Filter log lines containing the given text.

sincestring
Example:2h

Relative time window, for example 30s, 15m, 2h, 3d. Defaults to 15m. The time range cannot exceed 7 days.

startstring
Example:2026-06-01T12:00:00Z

Start of the time range. ISO 8601 date or epoch time (s, ms, us, or ns). Overrides since. The time range cannot exceed 7 days.

endstring
Example:now

End of the time range. ISO 8601 date, epoch time, or "now". Defaults to now.

order'asc' | 'desc'

Order of the returned log lines by timestamp. The endpoint sorts the time range before it applies limit, so desc returns the newest lines of the range and asc returns the oldest. Defaults to desc.

limitnumber

Maximum number of log lines to return. Narrow the time range or use the order parameter to reach lines outside the returned page.

Response

List of log entries

timestampstring required

Log line timestamp, ISO 8601 with nanosecond precision.

container_namestring required

Name of the container that produced the log line.

replicastring required

Name of the replica (pod) that produced the log line.

messagestring required

The log line content.

Example response

[
  {
    "timestamp": "2026-06-01T12:00:00.123456789Z",
    "container_name": "app",
    "replica": "my-deployment-6f9c8b7d5-x2abc",
    "message": "GET /healthz 200"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.