K8s

Get Kubernetes events over a specified time range.

post

Retrieves and filters Kubernetes events, allowing for sorting and pagination.

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

Endstring · date-timeRequired

End timestamp for the query range.

Limitinteger · uint32Optional

Maximum number of events to return.

Skipinteger · uint32Optional

Number of events to skip (for pagination).

SortBystring · enumRequired

Field to sort events by.

Possible values:

SortOrderstring · enumRequired

Sort order.

Possible values:

Startstring · date-timeRequired

Start timestamp for the query range.

WithRawEventsbooleanOptional

Include raw event data in the response.

searchstringOptional

Responses

200Success

No content

400

ErrorResponse defines a common error response structure.

500

ErrorResponse defines a common error response structure.

post

/api/k8s/v2/events-over-time

HTTPcURLJavaScriptPython

POST /api/k8s/v2/events-over-time HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1256

{
  "End": "2026-01-11T15:36:07.419Z",
  "Limit": 1,
  "Skip": 1,
  "SortBy": "timestamp",
  "SortOrder": "asc",
  "Sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "Start": "2026-01-11T15:36:07.419Z",
  "WithRawEvents": true,
  "conditions": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "group": {
    "conditions": [
      {
        "additionalFilter": "text",
        "autoComplete": true,
        "filterKeys": [
          "text"
        ],
        "filters": [
          {
            "op": "text",
            "value": null
          }
        ],
        "isNullable": true,
        "key": "text",
        "origin": "text",
        "type": "text"
      }
    ],
    "disabled": true,
    "groups": [
      {
        "conditions": [
          {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "filters": [
              {
                "op": "text",
                "value": null
              }
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          }
        ],
        "disabled": true,
        "groups": [
          {
            "conditions": [
              {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "filters": [
                  {
                    "op": "text",
                    "value": null
                  }
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            ],
            "disabled": true,
            "groups": "[Circular Reference]",
            "operator": "text"
          }
        ],
        "operator": "text"
      }
    ],
    "operator": "text"
  },
  "search": "text"
}

No content

post

Events search

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

enableStreambooleanOptional

EnableStream indicates if the response should be streamed

endstring · date-timeRequired

End time of the search range

filtersstringOptional

Extra filters to apply on the events

querystringOptional

LogsQL Query to filter events

startstring · date-timeRequired

Start time of the search range

Responses

200Success

No content

400

ErrorResponse defines a common error response structure.

500

ErrorResponse defines a common error response structure.

post

/api/k8s/v2/events/search

HTTPcURLJavaScriptPython

POST /api/k8s/v2/events/search HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 10756

{
  "enableStream": true,
  "end": "2026-01-11T15:36:07.419Z",
  "filters": "text",
  "pipeline": {
    "except": [
      {
        "additionalFilter": "text",
        "alias": "text",
        "autoComplete": true,
        "filterKeys": [
          "text"
        ],
        "isNullable": true,
        "key": "text",
        "origin": "text",
        "processors": [
          {
            "args": [
              "text"
            ],
            "op": "text"
          }
        ],
        "type": "text"
      }
    ],
    "filters": {
      "conditions": [
        {
          "additionalFilter": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "filters": [
            {
              "op": "text",
              "value": null
            }
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "type": "text"
        }
      ],
      "disabled": true,
      "groups": [
        {
          "conditions": [
            {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "filters": [
                {
                  "op": "text",
                  "value": null
                }
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            }
          ],
          "disabled": true,
          "groups": [
            "[Circular Reference]"
          ],
          "operator": "text"
        }
      ],
      "operator": "text"
    },
    "from": {
      "except": [
        {
          "additionalFilter": "text",
          "alias": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "processors": [
            {
              "args": [
                "text"
              ],
              "op": "text"
            }
          ],
          "type": "text"
        }
      ],
      "filters": {
        "conditions": [
          {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "filters": [
              {
                "op": "text",
                "value": null
              }
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          }
        ],
        "disabled": true,
        "groups": [
          {
            "conditions": [
              {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "filters": [
                  {
                    "op": "text",
                    "value": null
                  }
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            ],
            "disabled": true,
            "groups": [
              "[Circular Reference]"
            ],
            "operator": "text"
          }
        ],
        "operator": "text"
      },
      "from": {
        "except": [
          {
            "additionalFilter": "text",
            "alias": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "processors": [
              {
                "args": [
                  "text"
                ],
                "op": "text"
              }
            ],
            "type": "text"
          }
        ],
        "filters": {
          "conditions": [
            {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "filters": [
                {
                  "op": "text",
                  "value": null
                }
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            }
          ],
          "disabled": true,
          "groups": [
            {
              "conditions": [
                {
                  "additionalFilter": "text",
                  "autoComplete": true,
                  "filterKeys": [
                    "text"
                  ],
                  "filters": [
                    {
                      "op": "text",
                      "value": null
                    }
                  ],
                  "isNullable": true,
                  "key": "text",
                  "origin": "text",
                  "type": "text"
                }
              ],
              "disabled": true,
              "groups": [
                "[Circular Reference]"
              ],
              "operator": "text"
            }
          ],
          "operator": "text"
        },
        "from": {
          "except": [
            {
              "additionalFilter": "text",
              "alias": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "processors": [
                {
                  "args": [
                    "text"
                  ],
                  "op": "text"
                }
              ],
              "type": "text"
            }
          ],
          "filters": {
            "conditions": [
              {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "filters": [
                  {
                    "op": "text",
                    "value": null
                  }
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            ],
            "disabled": true,
            "groups": [
              {
                "conditions": [
                  {
                    "additionalFilter": "text",
                    "autoComplete": true,
                    "filterKeys": [
                      "text"
                    ],
                    "filters": [
                      {
                        "op": "text",
                        "value": null
                      }
                    ],
                    "isNullable": true,
                    "key": "text",
                    "origin": "text",
                    "type": "text"
                  }
                ],
                "disabled": true,
                "groups": [
                  "[Circular Reference]"
                ],
                "operator": "text"
              }
            ],
            "operator": "text"
          },
          "from": {
            "except": [
              {
                "additionalFilter": "text",
                "alias": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "processors": [
                  {
                    "args": [
                      "text"
                    ],
                    "op": "text"
                  }
                ],
                "type": "text"
              }
            ],
            "filters": {
              "conditions": [
                {
                  "additionalFilter": "text",
                  "autoComplete": true,
                  "filterKeys": [
                    "text"
                  ],
                  "filters": [
                    {
                      "op": "text",
                      "value": null
                    }
                  ],
                  "isNullable": true,
                  "key": "text",
                  "origin": "text",
                  "type": "text"
                }
              ],
              "disabled": true,
              "groups": [
                {
                  "conditions": [
                    {
                      "additionalFilter": "text",
                      "autoComplete": true,
                      "filterKeys": [
                        "text"
                      ],
                      "filters": [
                        {
                          "op": "text",
                          "value": null
                        }
                      ],
                      "isNullable": true,
                      "key": "text",
                      "origin": "text",
                      "type": "text"
                    }
                  ],
                  "disabled": true,
                  "groups": [
                    "[Circular Reference]"
                  ],
                  "operator": "text"
                }
              ],
              "operator": "text"
            },
            "from": "[Circular Reference]",
            "groupBy": [
              {
                "additionalFilter": "text",
                "alias": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "processors": [
                  {
                    "args": [
                      "text"
                    ],
                    "op": "text"
                  }
                ],
                "type": "text"
              }
            ],
            "having": "[Circular Reference]",
            "join": "[Circular Reference]",
            "limit": 1,
            "mathExpression": "[Circular Reference]",
            "offset": 1,
            "orderBy": [
              {
                "direction": "text",
                "selector": {
                  "additionalFilter": "text",
                  "alias": "text",
                  "autoComplete": true,
                  "filterKeys": [
                    "text"
                  ],
                  "isNullable": true,
                  "key": "text",
                  "origin": "text",
                  "processors": [
                    {
                      "args": [
                        "text"
                      ],
                      "op": "text"
                    }
                  ],
                  "type": "text"
                }
              }
            ],
            "selectors": [
              {
                "additionalFilter": "text",
                "alias": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "processors": [
                  {
                    "args": [
                      "text"
                    ],
                    "op": "text"
                  }
                ],
                "type": "text"
              }
            ]
          },
          "groupBy": [
            {
              "additionalFilter": "text",
              "alias": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "processors": [
                {
                  "args": [
                    "text"
                  ],
                  "op": "text"
                }
              ],
              "type": "text"
            }
          ],
          "having": {
            "conditions": [
              {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "filters": [
                  {
                    "op": "text",
                    "value": null
                  }
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            ],
            "disabled": true,
            "groups": "[Circular Reference]",
            "operator": "text"
          },
          "join": {
            "leftPipeline": "[Circular Reference]",
            "onConditions": [
              {
                "leftColumn": {
                  "additionalFilter": "text",
                  "autoComplete": true,
                  "filterKeys": [
                    "text"
                  ],
                  "isNullable": true,
                  "key": "text",
                  "origin": "text",
                  "type": "text"
                },
                "rightColumn": {
                  "additionalFilter": "text",
                  "autoComplete": true,
                  "filterKeys": [
                    "text"
                  ],
                  "isNullable": true,
                  "key": "text",
                  "origin": "text",
                  "type": "text"
                }
              }
            ],
            "rightPipeline": "[Circular Reference]",
            "type": "text"
          },
          "limit": 1,
          "mathExpression": [
            "[Circular Reference]"
          ],
          "offset": 1,
          "orderBy": [
            {
              "direction": "text",
              "selector": {
                "additionalFilter": "text",
                "alias": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "processors": [
                  {
                    "args": [
                      "text"
                    ],
                    "op": "text"
                  }
                ],
                "type": "text"
              }
            }
          ],
          "selectors": [
            {
              "additionalFilter": "text",
              "alias": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "processors": [
                {
                  "args": [
                    "text"
                  ],
                  "op": "text"
                }
              ],
              "type": "text"
            }
          ]
        },
        "groupBy": [
          {
            "additionalFilter": "text",
            "alias": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "processors": [
              {
                "args": [
                  "text"
                ],
                "op": "text"
              }
            ],
            "type": "text"
          }
        ],
        "having": {
          "conditions": [
            {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "filters": [
                {
                  "op": "text",
                  "value": null
                }
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            }
          ],
          "disabled": true,
          "groups": "[Circular Reference]",
          "operator": "text"
        },
        "join": {
          "leftPipeline": "[Circular Reference]",
          "onConditions": [
            {
              "leftColumn": {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              },
              "rightColumn": {
                "additionalFilter": "text",
                "autoComplete": true,
                "filterKeys": [
                  "text"
                ],
                "isNullable": true,
                "key": "text",
                "origin": "text",
                "type": "text"
              }
            }
          ],
          "rightPipeline": "[Circular Reference]",
          "type": "text"
        },
        "limit": 1,
        "mathExpression": [
          {
            "alias": "text",
            "args": "[Circular Reference]",
            "column": {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            },
            "math_operator": "text",
            "scalar": "text"
          }
        ],
        "offset": 1,
        "orderBy": [
          {
            "direction": "text",
            "selector": {
              "additionalFilter": "text",
              "alias": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "processors": [
                {
                  "args": [
                    "text"
                  ],
                  "op": "text"
                }
              ],
              "type": "text"
            }
          }
        ],
        "selectors": [
          {
            "additionalFilter": "text",
            "alias": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "processors": [
              {
                "args": [
                  "text"
                ],
                "op": "text"
              }
            ],
            "type": "text"
          }
        ]
      },
      "groupBy": [
        {
          "additionalFilter": "text",
          "alias": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "processors": [
            {
              "args": [
                "text"
              ],
              "op": "text"
            }
          ],
          "type": "text"
        }
      ],
      "having": {
        "conditions": [
          {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "filters": [
              {
                "op": "text",
                "value": null
              }
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          }
        ],
        "disabled": true,
        "groups": "[Circular Reference]",
        "operator": "text"
      },
      "join": {
        "leftPipeline": "[Circular Reference]",
        "onConditions": [
          {
            "leftColumn": {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            },
            "rightColumn": {
              "additionalFilter": "text",
              "autoComplete": true,
              "filterKeys": [
                "text"
              ],
              "isNullable": true,
              "key": "text",
              "origin": "text",
              "type": "text"
            }
          }
        ],
        "rightPipeline": "[Circular Reference]",
        "type": "text"
      },
      "limit": 1,
      "mathExpression": [
        {
          "alias": "text",
          "args": "[Circular Reference]",
          "column": {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          },
          "math_operator": "text",
          "scalar": "text"
        }
      ],
      "offset": 1,
      "orderBy": [
        {
          "direction": "text",
          "selector": {
            "additionalFilter": "text",
            "alias": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "processors": [
              {
                "args": [
                  "text"
                ],
                "op": "text"
              }
            ],
            "type": "text"
          }
        }
      ],
      "selectors": [
        {
          "additionalFilter": "text",
          "alias": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "processors": [
            {
              "args": [
                "text"
              ],
              "op": "text"
            }
          ],
          "type": "text"
        }
      ]
    },
    "groupBy": [
      {
        "additionalFilter": "text",
        "alias": "text",
        "autoComplete": true,
        "filterKeys": [
          "text"
        ],
        "isNullable": true,
        "key": "text",
        "origin": "text",
        "processors": [
          {
            "args": [
              "text"
            ],
            "op": "text"
          }
        ],
        "type": "text"
      }
    ],
    "having": {
      "conditions": [
        {
          "additionalFilter": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "filters": [
            {
              "op": "text",
              "value": null
            }
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "type": "text"
        }
      ],
      "disabled": true,
      "groups": "[Circular Reference]",
      "operator": "text"
    },
    "join": {
      "leftPipeline": "[Circular Reference]",
      "onConditions": [
        {
          "leftColumn": {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          },
          "rightColumn": {
            "additionalFilter": "text",
            "autoComplete": true,
            "filterKeys": [
              "text"
            ],
            "isNullable": true,
            "key": "text",
            "origin": "text",
            "type": "text"
          }
        }
      ],
      "rightPipeline": "[Circular Reference]",
      "type": "text"
    },
    "limit": 1,
    "mathExpression": [
      {
        "alias": "text",
        "args": "[Circular Reference]",
        "column": {
          "additionalFilter": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "type": "text"
        },
        "math_operator": "text",
        "scalar": "text"
      }
    ],
    "offset": 1,
    "orderBy": [
      {
        "direction": "text",
        "selector": {
          "additionalFilter": "text",
          "alias": "text",
          "autoComplete": true,
          "filterKeys": [
            "text"
          ],
          "isNullable": true,
          "key": "text",
          "origin": "text",
          "processors": [
            {
              "args": [
                "text"
              ],
              "op": "text"
            }
          ],
          "type": "text"
        }
      }
    ],
    "selectors": [
      {
        "additionalFilter": "text",
        "alias": "text",
        "autoComplete": true,
        "filterKeys": [
          "text"
        ],
        "isNullable": true,
        "key": "text",
        "origin": "text",
        "processors": [
          {
            "args": [
              "text"
            ],
            "op": "text"
          }
        ],
        "type": "text"
      }
    ]
  },
  "query": "text",
  "sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "start": "2026-01-11T15:36:07.419Z"
}

No content

Get clusters list.

post

Retrieves a list of Kubernetes clusters based on provided source filters.

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

Responses

200

Add response wrapper definition ---

No content

400

ErrorResponse defines a common error response structure.

500

ErrorResponse defines a common error response structure.

post

/api/k8s/v3/clusters/list

HTTPcURLJavaScriptPython

POST /api/k8s/v3/clusters/list HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "Sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ]
}

No content

Get workloads list.

post

Retrieves a list of Kubernetes workloads based on provided source filters, conditions, sorting, and pagination.

Required scopes

This endpoint requires the following scopes:

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

Limitinteger · uint32Optional

OrderstringOptional

Skipinteger · uint32Optional

SortBystringOptional

Responses

200Success

No content

400

ErrorResponse defines a common error response structure.

500

ErrorResponse defines a common error response structure.

post

/api/k8s/v3/workloads/list

HTTPcURLJavaScriptPython

POST /api/k8s/v3/workloads/list HTTP/1.1
Host: api.groundcover.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 418

{
  "Conditions": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ],
  "Limit": 1,
  "Order": "text",
  "Skip": 1,
  "SortBy": "text",
  "Sources": [
    {
      "additionalFilter": "text",
      "autoComplete": true,
      "filterKeys": [
        "text"
      ],
      "filters": [
        {
          "op": "text",
          "value": null
        }
      ],
      "isNullable": true,
      "key": "text",
      "origin": "text",
      "type": "text"
    }
  ]
}

No content