---
title: "Retrieve GitOps logs"
method: GET
path: "/api/v1/gitops-logs"
tags: ["GitOps Logs"]
---

# Retrieve GitOps logs

`GET /api/v1/gitops-logs`

API key must have the `View GitOps logs` permission.

## Query parameters

- `file` string
- `repository` string
- `sha` string
- `errorOnly` boolean
- `operation` 'CREATED' | 'UPDATED' | 'ARCHIVED' | 'NO_CHANGE'
- `page` integer, required
- `pageSize` integer, required
- `fileName` string
- `scorecardTag` string, required
- `workflowTag` string
- `tag` string, required — The entity tag (`x-cortex-tag`) that identifies the entity.

## Response `200`

Retrieve GitOps logs based on given criteria

- GitOpsLogPaginatedResponse
  - `logs` GitOpsLogResponse[], required
    - `commit` string, required
    - `dateCreated` string, date-time, required
    - `files` GitOpsLogFileResponse[], required
      - `entity` GitOpsLogEntityChange
        - `name` string, required
        - `operation` 'CREATED' | 'UPDATED' | 'ARCHIVED' | 'NO_CHANGE', required
        - `tag` string, required
        - `type` string, required
      - `error` GitOpsLogFileErrorResponse
        - `errorType` string, required
        - `message` string, required
      - `fileName` string, required
      - `isPackageFile` boolean, required
      - `scorecard` GitOpsLogScorecardChange
        - `name` string, required
        - `operation` 'CREATED' | 'UPDATED' | 'ARCHIVED' | 'NO_CHANGE', required
        - `tag` string, required
      - `workflow` GitOpsLogWorkflowChange
        - `name` string, required
        - `operation` 'CREATED' | 'UPDATED' | 'ARCHIVED' | 'NO_CHANGE', required
        - `tag` string, required
    - `repository` GitOpsLogRepositoryResponse, required
      - `provider` 'AZURE_DEVOPS' | 'BITBUCKET' | 'GITHUB' | 'GITLAB', required — Git provider (GitHub, GitLab, etc.)
      - `repositoryName` string, required — Repository name as defined in your Git provider
  - `page` integer, required — Current page number, 0-indexed
  - `total` integer, required — Total number of results
  - `totalPages` integer, required — Total number of pages

## Other responses

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

---

[API](https://skmtc.dev/cortex/apis/cortex-api.md) · [All operations](https://skmtc.dev/cortex/apis/cortex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cortex/cortex-api/revisions/141799a965b4/schema)