# Resource schemas

Generated fields and validation rules for kuery workspace resources.

Source: https://faros.sh/docs/reference/providers/kuery/schemas/


## Compatibility and access

Generated from [product commit `6f341b4e6d35`](https://github.com/faroshq/faros/commit/6f341b4e6d356dd28d1a90ec65e220b98a9bbb96). This is a source snapshot, not a guarantee that your deployment runs this version.

These resource schemas describe provider configuration. Check your deployed API discovery for the schema installed in your hub. Use the intended [workspace context](https://faros.sh/docs/reference/cli/resources/) and an identity permitted to read or change the resource. Required fields below are required within their containing object; optional parent objects may be omitted.

[Download complete schemas](https://faros.sh/schemas/kuery.json), including nested validation rules and status definitions. This page covers Kubernetes-style resources; provider HTTP actions and runtime behavior are separate contracts. Return to [API reference](https://faros.sh/docs/reference/providers/kuery/) for those interfaces and related guides.

## SavedView (v1alpha1)

API: `kuery.providers.faros.sh/v1alpha1` · Resource: `savedviews` · Scope: `Namespaced`

[Source schema](https://github.com/faroshq/faros/blob/6f341b4e6d356dd28d1a90ec65e220b98a9bbb96/providers/kuery/deploy/chart/files/schemas/savedviews.kuery.providers.faros.sh.yaml)

```bash
kubectl explain savedviews.kuery.providers.faros.sh --api-version=kuery.providers.faros.sh/v1alpha1 --recursive
```

| Field | Type | Required in parent | Description and constraints |
| --- | --- | --- | --- |
| `spec` | object | No | No description supplied by the source schema. |
| `spec.displayName` | string | No | Human-readable name shown in the portal. maxLength: 128 |
| `spec.description` | string | No | maxLength: 512 |
| `spec.root` | object | No | The object the view is anchored on. Cluster is the faros edge name; empty matches any engaged edge. |
| `spec.root.cluster` | string | No | maxLength: 256 |
| `spec.root.apiGroup` | string | No | maxLength: 256 |
| `spec.root.kind` | string | No | maxLength: 128 |
| `spec.root.namespace` | string | No | maxLength: 63 |
| `spec.root.name` | string | No | maxLength: 253 |
| `spec.relations` | array[string] | No | Kuery relation names to expand from the root (owners, owners+, descendants, descendants+, references, selects, selected-by, events, linked, linked+, grouped). maxItems: 16 |
| `spec.maxDepth` | integer | No | Transitive relation depth cap. minimum: 1; maximum: 20 |
| `status` | object | No | No description supplied by the source schema. |
| `status.lastOpenedAt` | string | No | No description supplied by the source schema. |