---
title: "Get Network Site Assignment Rule"
method: POST
path: "/network-site-assignment-rule/{id}/get-item"
tags: ["Network Site Assignment Rule"]
---

# Get Network Site Assignment Rule

`POST /network-site-assignment-rule/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/network-site-assignment-rule/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/network-site-assignment-rule/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single Network Site Assignment Rule by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `select` NetworkSiteAssignmentRuleSelectSchema: Select schema for NetworkSiteAssignmentRule. Set fields to true to include them in the response.
    - `_id` boolean
    - `createdAt` boolean
    - `updatedAt` boolean
    - `deletedAt` boolean
    - `criteria` boolean
    - `projectId` boolean
    - `siteId` boolean
    - `subnetCidr` boolean
    - `hostnamePattern` boolean
    - `priority` boolean
    - `createdByUserId` boolean
    - `deletedByUserId` boolean

## Response `200`

Successful response

- object
  - `data` NetworkSiteAssignmentRule
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `version` number: Object version
    - `criteria` object: Versioned conditions that determine whether this rule matches a resource. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `projectId` string, uuid, required: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [No access - you don't have permission for this operation]
    - `siteId` string, uuid, required: ID of the Network Site matched resources are assigned to. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `subnetCidr` string: Devices and endpoints with an IP in this CIDR are assigned to the site. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `hostnamePattern` string: Devices whose hostname, SNMP system name, display name or DNS name matches this wildcard pattern are assigned to the site. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `priority` number: Where this rule sits in the list: when several rules match a device, the one highest in the list wins. The rule at the top has the highest number. A new rule is added to the end of the list, with the lowest number. Setting a number another rule already has puts this rule in that place, and the rules in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Network Site Assignment Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Network Site Assignment Rule]
    - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [No access - you don't have permission for this operation]
    - `deletedByUserId` string, uuid: User ID who deleted this object (if this object was deleted by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Network Site Assignment Rule], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)