---
title: "Update Remote Mount Backend"
method: PATCH
path: "/remote_mount_backends/{id}"
tags: ["remote_mount_backends", "Remote Mount Backends"]
---

# Update Remote Mount Backend

`PATCH /remote_mount_backends/{id}`

Update Remote Mount Backend

## Path parameters

- `id` integer, required

## Response `200`

The RemoteMountBackends object.

- RemoteMountBackendEntity — RemoteMountBackendEntity model
  - `canary_file_path` string — Path to the canary file used for health checks.
  - `enabled` boolean — True if this backend is enabled.
  - `fall` integer — Number of consecutive failures before considering the backend unhealthy.
  - `health_check_enabled` boolean — True if health checks are enabled for this backend.
  - `health_check_results` object[] — Array of recent health check results.
  - `health_check_type` 'active' | 'passive' — Type of health check to perform.
  - `id` integer — Unique identifier for this backend.
  - `interval` integer — Interval in seconds between health checks.
  - `min_free_cpu` string, decimal — Minimum free CPU percentage required for this backend to be considered healthy.
  - `min_free_mem` string, decimal — Minimum free memory percentage required for this backend to be considered healthy.
  - `priority` integer — Priority of this backend.
  - `remote_path` string — Path on the remote server to treat as the root of this mount.
  - `remote_server_id` integer — The remote server that this backend is associated with.
  - `remote_server_mount_id` integer — The mount ID of the Remote Server Mount that this backend is associated with.
  - `rise` integer — Number of consecutive successes before considering the backend healthy.
  - `status` 'healthy' | 'degraded' | 'failed' | 'desynced' — Status of this backend.
  - `undergoing_maintenance` boolean — True if this backend is undergoing maintenance.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/versions/c80c746637fd/schema)