---
title: "Update Connection"
method: PATCH
path: "/v1/connections/{connection_id}"
tags: ["connections"]
---

# Update Connection

`PATCH /v1/connections/{connection_id}`

Update a connection's status or timestamps.

Only the fields provided in the request body will be updated.
The connection must belong to a machine owned by the authenticated organization.

## Path parameters

- `connection_id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- ConnectionUpdate — Schema for updating a connection
  - `status` 'connected' | 'disconnected' | 'error'
  - `last_ping` string, date-time, nullable
  - `disconnected_at` string, date-time, nullable

## Response `200`

Successful Response

- ConnectionResponse — Connection response schema
  - `websocket_id` string, required
  - `ip_address` string, nullable
  - `user_agent` string, nullable
  - `id` string, uuid, required
  - `machine_id` string, uuid, required
  - `connected_at` string, date-time, required
  - `disconnected_at` string, date-time, nullable, required
  - `last_ping` string, date-time, required
  - `status` 'connected' | 'disconnected' | 'error', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/versions/830d2f48963d/schema)