---
title: SensorRequestState type | Wartiva GraphQL API
description: Contains the current state of the SensorRequest. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/sensor-request-state.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `SensorRequestState` type

Contains the current state of the SensorRequest.

## Fields

| Field Name | Description |
|---|---|
| `tryAllEndpoints` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | If true this request will be attempted for each available Endpoint until the request is expired. Set for UDP requests in the SAE zone, where running the sensor is used to learn the port status. |
| `lastRequested` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The last time this request was requested to be run. |
| `lastRequestedVersion` - [`String!`](https://wartiva.com/api-docs/types/string.html) | The version of the software that last requested this request. |
| `expiration` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The expiration time for this request. |
| `canRun` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | True if the request has completed at least once since it was last requested. |
| `lastCompleted` - [`Time`](https://wartiva.com/api-docs/types/time.html) | The time this request was last completed. |
| `lastCompletedVersion` - [`String`](https://wartiva.com/api-docs/types/string.html) | The version of the software that last completed this request. |
| `numEndpointsCompleted` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of Endpoints that have completed this request since it was last requested. |
| `endpointsCompleted` - [`[Endpoint!]`](https://wartiva.com/api-docs/types/endpoint.html) | List of EndpointIds that have completed this request since it was last requested. |
| Arguments `count` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of endpoint IDs to return. |
| `numEndpointsSuppressed` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The total number of Endpoints that could not complete the sensor request and are suppressed from running. |
| `endpointsSuppressed` - [`[Endpoint!]`](https://wartiva.com/api-docs/types/endpoint.html) | List of all Endpoint unique identifiers could not complete the sensor request and are suppressed from running for any reason. |
| Arguments `count` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of endpoint IDs to return. |
| `numEndpointsSuppressedDeviceIpOffline` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of numEndpointsSuppressed suppressed from running because the Endpoint could not connect to the Device's IP address or the IP is seen on a different Device. |
| `endpointsSuppressedDeviceIpOffline` - [`[Endpoint!]`](https://wartiva.com/api-docs/types/endpoint.html) | Subset of endpointsSuppressed suppressed from running because the Endpoint could not connect to the Device's IP address or the IP is seen on a different Device. |
| Arguments `count` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of endpoint IDs to return. |
| `numEndpointsSuppressedTcpPortClosed` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of numEndpointsSuppressed suppressed from running because the Endpoint could not connect to the TCP port. |
| `endpointsSuppressedTcpPortClosed` - [`[Endpoint!]`](https://wartiva.com/api-docs/types/endpoint.html) | Subset of endpointsSuppressed suppressed from running because the Endpoint could not connect to the TCP port. |
| Arguments `count` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of endpoint IDs to return. |
| `numEndpointsSuppressedError` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of numEndpointsSuppressed suppressed from running because the an unexpected error was encountered attempting to run the sensor request. |
| `endpointsSuppressedError` - [`[Endpoint!]`](https://wartiva.com/api-docs/types/endpoint.html) | Subset of endpointsSuppressed suppressed from running because the an unexpected error was encountered attempting to run the sensor request. |
| Arguments `count` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of endpoint IDs to return. |
| `lastUpdated` - [`Time`](https://wartiva.com/api-docs/types/time.html) | The time this request was last updated. |

## Used by

- [`SensorRequest`](https://wartiva.com/api-docs/types/sensor-request.html) type: A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.

## Related types

- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.

## Example

### Example

```json
{
  "tryAllEndpoints": true,
  "lastRequested": "2021-10-07T18:23:25.829Z",
  "lastRequestedVersion": "abc123",
  "expiration": "2021-10-07T18:23:25.829Z",
  "canRun": true,
  "lastCompleted": "2021-10-07T18:23:25.829Z",
  "lastCompletedVersion": "abc123",
  "numEndpointsCompleted": 987,
  "endpointsCompleted": [Endpoint],
  "numEndpointsSuppressed": 987,
  "endpointsSuppressed": [Endpoint],
  "numEndpointsSuppressedDeviceIpOffline": 987,
  "endpointsSuppressedDeviceIpOffline": [Endpoint],
  "numEndpointsSuppressedTcpPortClosed": 123,
  "endpointsSuppressedTcpPortClosed": [Endpoint],
  "numEndpointsSuppressedError": 123,
  "endpointsSuppressedError": [Endpoint],
  "lastUpdated": "2021-10-07T18:23:25.829Z"
}

```

---

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