---
title: "List Cluster Logs"
method: GET
path: "/organization/{organizationId}/cluster/{clusterId}/logs"
tags: ["Clusters"]
---

# List Cluster Logs

`GET /organization/{organizationId}/cluster/{clusterId}/logs`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/organization/{organizationId}/cluster/{clusterId}/logs`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/organization/:organizationId/cluster/:clusterId/logs/get.ts> (a function with typed inputs; its response is checked against the schema)

List Cluster Logs

## Path parameters

- `organizationId` string, uuid, required
- `clusterId` string, uuid, required

## Response `200`

list cluster logs

- ClusterLogsResponseList
  - `results` ClusterLogs[]
    - `type` string: log level
    - `timestamp` string, date-time: log date creation
    - `step` 'LoadConfiguration' | 'Create' | 'Created' | 'CreateError' | 'Pause' | 'Paused' | 'PauseError' | 'Delete' | 'Deleted' | 'DeleteError' | 'RetrieveClusterConfig' | 'RetrieveClusterResources' | 'ValidateSystemRequirements' | 'UnderMigration' | 'Unknown': log step
    - `message` object
      - `safe_message` string: log global message
    - `error` object: Present only for `error` log
      - `tag` string: log error tag
      - `user_log_message` string: log details about the error
      - `link` string: link to our documentation
      - `hint_message` string: hint the user can follow
      - `event_details` object
        - `provider_kind` string: cloud provider used
        - `region` string
        - `transmitter` object
          - `type` string
          - `id` string
          - `name` string
      - `underlying_error` object
        - `message` string: technical details about the error
    - `details` object: Present only for `info`, `warning` and `debug` logs
      - `provider_kind` string: cloud provider used
      - `region` string
      - `transmitter` object
        - `type` string
        - `id` string
        - `name` string

## Other responses

- `401`: Access token is missing or invalid
- `403`: Access forbidden
- `404`: Resource not found

---

[API](https://skmtc.dev/qovery/apis/qovery-api.md) - [All operations](https://skmtc.dev/qovery/apis/qovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qovery/apis/qovery-api/revisions/93c4960a44ba?raw)