---
title: Xattr type | Wartiva GraphQL API
description: A single extended attribute (xattr) entry. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/xattr.html
updated: 2026-10-07
---

File path sensors · GraphQL type

# `Xattr` type

A single extended attribute (xattr) entry. The raw bytes are preserved verbatim; if the bytes form valid UTF-8, the decoded string is also provided as a convenience.

## Fields

| Field Name | Description |
|---|---|
| `keyRaw` - [`Binary!`](https://wartiva.com/api-docs/types/binary.html) | Raw xattr key bytes as collected from the filesystem. |
| `keyString` - [`String`](https://wartiva.com/api-docs/types/string.html) | UTF-8 decoded form of keyRaw. Null when keyRaw is not valid UTF-8. |
| `valueRaw` - [`Binary!`](https://wartiva.com/api-docs/types/binary.html) | Raw xattr value bytes as collected from the filesystem. |
| `valueString` - [`String`](https://wartiva.com/api-docs/types/string.html) | UTF-8 decoded form of valueRaw. Null when valueRaw is not valid UTF-8. |

## Used by

- [`EndpointPathLinux`](https://wartiva.com/api-docs/types/endpoint-path-linux.html) type: Linux-specific EndpointPath fields.
- [`EndpointPathMacOS`](https://wartiva.com/api-docs/types/endpoint-path-mac-os.html) type: macOS-specific EndpointPath fields.

## Example

### Example

```json
{
  "keyRaw": Binary,
  "keyString": "xyz789",
  "valueRaw": Binary,
  "valueString": "xyz789"
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt