---
title: QueueExpression type | Wartiva GraphQL API
description: QueueExpression represents an nftables expression for sending packets to a userspace queue. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/queue-expression.html
updated: 2026-10-07
---

Endpoint configuration · GraphQL type

# `QueueExpression` type

QueueExpression represents an nftables expression for sending packets to a userspace queue. This allows external applications to inspect, modify, or make decisions on packets.

## Fields

| Field Name | Description |
|---|---|
| `num` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | Netlink queue to send messages to, returned as an unsigned 16-bit integer. |
| `total` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | Number of queues to load balance packets on, returned as an unsigned 16-bit integer. |
| `flag` - [`QueueFlag!`](https://wartiva.com/api-docs/types/queue-flag.html) | Flags to control the behavior of the queue operation (e.g., BYPASS, CPU_FAN_OUT). |
| `srcRegister` - [`NftRegister!`](https://wartiva.com/api-docs/types/nft-register.html) | Source register of queue number. |

## Used by

- [`ChainExpression`](https://wartiva.com/api-docs/types/chain-expression.html) union: A union of all possible nftables chain expression types.

## Example

### Example

```json
{"num": 123, "total": 987, "flag": "BYPASS", "srcRegister": "VERDICT"}

```

---

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