GitOps Logs

Use these operations to interact with GitOps logs in Cortex.

Required permissions

Your API key must have the View GitOps logs permission.

Operations

Retrieve GitOps logs

get

API key must have the View GitOps logs permission.

Authorizations

bearerAuth

AuthorizationstringRequired

All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.

Query parameters

filestringOptional

File name the within repository

repositorystringOptional

Repository name as defined in your Git provider

shastringOptional

Commit SHA

errorOnlybooleanOptional

Filter by error only

operationstring · enumOptional

Filter by operation

Possible values:

pageinteger · int32Required

Page number to return, 0-indexed. Default 0.

Default: 0

pageSizeinteger · int32Required

Number of results to return per page, between 1 and 1000. Default 250.

Default: 250

fileNamestringOptional

scorecardTagstringRequired

Unique tag for the Scorecard.

workflowTagstringOptional

tagstringRequired

The entity tag (x-cortex-tag) that identifies the entity.

Responses

200

Retrieve GitOps logs based on given criteria

application/json

429

The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

application/problem+json

get

/api/v1/gitops-logs

HTTPcURLJavaScriptPython

GET /api/v1/gitops-logs?page=0&pageSize=250&scorecardTag=text&tag=text HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "logs": [
    {
      "commit": "text",
      "dateCreated": "2025-11-13T00:27:07.641Z",
      "files": [
        {
          "entity": {
            "name": "text",
            "operation": "CREATED",
            "tag": "text",
            "type": "text"
          },
          "error": {
            "errorType": "text",
            "message": "text"
          },
          "fileName": "text",
          "isPackageFile": true,
          "scorecard": {
            "name": "text",
            "operation": "CREATED",
            "tag": "text"
          },
          "workflow": {
            "name": "text",
            "operation": "CREATED",
            "tag": "text"
          }
        }
      ],
      "repository": {
        "provider": "AZURE_DEVOPS",
        "repositoryName": "cortexapps/catalog"
      }
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}