---
title: "POST /endpoints/agents/connectors/check_in/"
method: POST
path: "/endpoints/agents/connectors/check_in/"
tags: ["endpoints"]
---

# POST /endpoints/agents/connectors/check_in/

`POST /endpoints/agents/connectors/check_in/`

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

## Request body

- DeviceFactsRequest
  - `os` OperatingSystemRequest — 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` DiskRequest[], nullable
    - `name` string, required
    - `mountpoint` string, required
    - `label` string
    - `capacity_total_bytes` integer
    - `capacity_used_bytes` integer
    - `encryption_enabled` boolean
  - `network` NetworkRequest
    - `hostname` string, required
    - `firewall_enabled` boolean
    - `interfaces` NetworkInterfaceRequest[], required
      - `name` string, required
      - `hardware_address` string, required
      - `ip_addresses` string[]
      - `dns_servers` string[]
    - `gateway` string
  - `hardware` HardwareRequest
    - `model` string
    - `manufacturer` string
    - `serial` string, required
    - `cpu_name` string
    - `cpu_count` integer
    - `memory_bytes` integer
  - `software` SoftwareRequest[], nullable
    - `name` string, required
    - `version` string
    - `source` string, required
    - `path` string
  - `processes` ProcessRequest[], nullable
    - `id` integer, required
    - `name` string, required
    - `user` string
  - `users` DeviceUserRequest[], nullable
    - `id` string, required
    - `username` string
    - `name` string
    - `home` string
  - `groups` DeviceGroupRequest[], nullable
    - `id` string, required
    - `name` string
  - `vendor` object

## Response `204`

Successfully checked in

## 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)