---
title: createPathSensor mutation | Wartiva GraphQL API
description: Creates a new PathSensor for the given organization. Default sensors are seeded automatically and cannot be created via this mutation.
url: https://wartiva.com/api-docs/mutations/create-path-sensor.html
updated: 2026-10-07
---

Organizations and users · GraphQL mutation

# `createPathSensor` mutation

Creates a new PathSensor for the given organization. Default sensors are seeded automatically and cannot be created via this mutation. Caller must be an organization admin of input.orgId.

## Response

Returns a [`PathSensorPayload!`](https://wartiva.com/api-docs/types/path-sensor-payload.html)

## Arguments

| Name | Description |
|---|---|
| `input` - [`CreatePathSensorInput!`](https://wartiva.com/api-docs/types/create-path-sensor-input.html) | The new PathSensor to create. |

## Example

### Query

```graphql
mutation createPathSensor($input: CreatePathSensorInput!) {
  createPathSensor(input: $input) {
    node {
      id
      orgId
      name
      description
      path
      inclusions
      exclusions
      recursive
      interval
      collectChecksum
      checksumMaxBytes
      collectContents
      collectAcls
      contentMaxBytes
      isDefault
      enabled
      osTarget {
        ...PathSensorOsTargetFragment
      }
    }
  }
}

```

### Variables

```json
{"input": CreatePathSensorInput}

```

### Response

```json
{"data": {"createPathSensor": {"node": PathSensor}}}

```

## Related operations

- [`pathSensor`](https://wartiva.com/api-docs/queries/path-sensor.html) query: Retrieves a PathSensor configuration: an organization-wide instruction for endpoints to collect file metadata, and optionally checksums, ACLs, or…
- [`updatePathSensor`](https://wartiva.com/api-docs/mutations/update-path-sensor.html) mutation: Updates an existing user-defined PathSensor.

---

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