---
title: "PATCH /endpoints/devices/{device_uuid}/"
method: PATCH
path: "/endpoints/devices/{device_uuid}/"
tags: ["endpoints"]
---

# PATCH /endpoints/devices/{device_uuid}/

`PATCH /endpoints/devices/{device_uuid}/`

Mixin to add a used_by endpoint to return a list of all objects using this object

## Path parameters

- `device_uuid` string, uuid, required

## Request body

- PatchedEndpointDeviceRequest
  - `device_uuid` string, uuid
  - `name` string
  - `access_group` string, uuid, nullable
  - `access_group_obj` DeviceAccessGroupRequest
    - `name` string, required
    - `attributes` object
  - `expiring` boolean
  - `expires` string, date-time, nullable
  - `attributes` object

## Response `200`

- EndpointDevice
  - `device_uuid` string, uuid
  - `pbm_uuid` string, uuid, required
  - `name` string, required
  - `access_group` string, uuid, nullable
  - `access_group_obj` DeviceAccessGroup
    - `pbm_uuid` string, uuid, required
    - `name` string, required
    - `attributes` object
  - `expiring` boolean
  - `expires` string, date-time, nullable
  - `facts` DeviceFactSnapshot, required
    - `data` DeviceFacts, required
      - `os` OperatingSystem — For example: {"family":"linux","name":"Ubuntu","version":"24.04.3 LTS (Noble Numbat)","arch":"amd64"} {"family": "windows","name":"Server 2022 Datacenter","version":"10.0.20348.4405","arch":"amd64"} {"family": "windows","name":"Server 2022 Datacenter","version":"10.0.20348.4405","arch":"amd64"} {"family": "mac_os", "name": "", "version": "26.2", "arch": "arm64"}
        - `family` 'linux' | 'unix' | 'bsd' | 'windows' | 'mac_os' | 'android' | 'i_os' | 'other', required
        - `name` string — Operating System name, such as 'Server 2022' or 'Ubuntu'
        - `version` string — Operating System version, must always be the version number but may contain build name
        - `arch` string
      - `disks` Disk[], nullable
        - `name` string, required
        - `mountpoint` string, required
        - `label` string
        - `capacity_total_bytes` integer
        - `capacity_used_bytes` integer
        - `encryption_enabled` boolean
      - `network` Network
        - `hostname` string, required
        - `firewall_enabled` boolean
        - `interfaces` NetworkInterface[], required
          - `name` string, required
          - `hardware_address` string, required
          - `ip_addresses` string[]
          - `dns_servers` string[]
        - `gateway` string
      - `hardware` Hardware
        - `model` string
        - `manufacturer` string
        - `serial` string, required
        - `cpu_name` string
        - `cpu_count` integer
        - `memory_bytes` integer
      - `software` Software[], nullable
        - `name` string, required
        - `version` string
        - `source` string, required
        - `path` string
      - `processes` Process[], nullable
        - `id` integer, required
        - `name` string, required
        - `user` string
      - `users` DeviceUser[], nullable
        - `id` string, required
        - `username` string
        - `name` string
        - `home` string
      - `groups` DeviceGroup[], nullable
        - `id` string, required
        - `name` string
      - `vendor` object
    - `connection` string, uuid, required
    - `created` string, date-time, required
    - `expires` string, date-time, nullable, required
    - `vendor` 'goauthentik.io/@merged' | 'goauthentik.io/platform' | 'fleetdm.com' | 'chrome.google.com', required
  - `attributes` object

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)