Skip to main content
GET
/
api
/
svc
/
v1
/
logs
Get application logs
curl --request GET \
  --url https://{controlPlaneURL}/api/svc/v1/logs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "log": "<string>",
      "stream": "stdout",
      "time": "1635467890123456789",
      "job_name": "<string>",
      "containerName": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

startTs
string | null

Start timestamp for querying logs, in nanoseconds from the Unix epoch.

Example:

"1779262323000000000"

endTs
string | null

End timestamp for querying logs, in nanoseconds from the Unix epoch.

Example:

"1779348723000000000"

limit
integer | null
default:5000

Maximum number of log lines to fetch.

direction
enum<string>

Direction of sorting logs by timestamp.

Available options:
asc,
desc
numLogsToIgnore
integer | null

Number of log lines at the start timestamp to skip.

applicationId
string | null

Unique identifier of the application. Either applicationId or applicationFqn must be provided.

applicationFqn
string | null

FQN of the application. Either applicationId or applicationFqn must be provided.

deploymentId
string | null

Unique identifier of the deployment.

jobRunName
string | null

Name of the job run whose logs to fetch.

podName
string | null

Name of a single pod whose logs to fetch. Cannot be used together with podNames or podNamesRegex.

containerName
string | null

Name of the container whose logs to fetch.

podNames
string[] | null

List of pod names whose logs to fetch. Cannot be used together with podName or podNamesRegex.

podNamesRegex
string | null

Regex pattern matching pod names whose logs to fetch. Cannot be used together with podName or podNames.

searchFilters
string | null

JSON-encoded array of search filters; each item is { string, type, operator }. Takes precedence over searchString when provided.

Example:

"[{\"string\":\"error\",\"type\":\"substring\",\"operator\":\"equal\"}]"

searchString
string | null

Substring or regex to match against log content. Used when searchFilters is not provided.

searchType
enum<string>

How searchString should be matched against log content. Query filter type for logs search

Available options:
regex,
substring,
ignore_case_substring
searchOperator
enum<string>

Comparison operator applied to the searchString match. Comparison operator logs search

Available options:
equal,
not_equal

Response

Logs matching the query parameters.

data
Log · object[]
required

List of logs