---
title: userGetMetadata query | Wartiva GraphQL API
description: Reads one value from the caller's own key-value metadata store, which clients use to keep per-user preferences and UI state on the server.
url: https://wartiva.com/api-docs/queries/user-get-metadata.html
updated: 2026-10-07
---

Organizations and users · GraphQL query

# `userGetMetadata` query

Reads one value from the caller's own key-value metadata store, which clients use to keep per-user preferences and UI state on the server. A key that has never been set returns a null value rather than an error. Write values with [userSetMetadata](https://wartiva.com/api-docs/queries/user-set-metadata.html).

## Response

Returns a [`UserMetadataPayload!`](https://wartiva.com/api-docs/types/user-metadata-payload.html)

## Arguments

| Name | Description |
|---|---|
| `key` - [`String!`](https://wartiva.com/api-docs/types/string.html) | The metadata key, 1 to 256 bytes. |

## Example

### Query

```graphql
query userGetMetadata($key: String!) {
  userGetMetadata(key: $key) {
    key
    value
  }
}

```

### Variables

```json
{"key": "abc123"}

```

### Response

```json
{
  "data": {
    "userGetMetadata": {
      "key": "abc123",
      "value": Binary
    }
  }
}

```

---

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