---
title: "Download configuration file (required for some Remote Server integrations, such as the Files.com Agent)"
method: GET
path: "/remote_servers/{id}/configuration_file"
tags: ["remote_servers", "Remote Server Configuration Files"]
---

# Download configuration file (required for some Remote Server integrations, such as the Files.com Agent)

`GET /remote_servers/{id}/configuration_file`

Download configuration file (required for some Remote Server integrations, such as the Files.com Agent)

## Path parameters

- `id` integer, required

## Response `200`

The RemoteServers object.

- RemoteServerConfigurationFileEntity — RemoteServerConfigurationFileEntity model
  - `id` integer — The remote server ID of the agent
  - `permission_set` string — The permission set for the agent ['read_write', 'read_only', 'write_only']
  - `private_key` string — The private key for the agent
  - `subdomain` string — Files.com subdomain site name
  - `root` string — The root directory for the agent
  - `node_name` string — Optional customer-facing name for this Agent installation
  - `follow_links` boolean — Follow symlinks when traversing directories
  - `prefer_protocol` string — Preferred network protocol ['udp', 'tcp'] (default udp)
  - `dns` string — DNS lookup method ['auto','doh','system'] (default auto)
  - `proxy_all_outbound` boolean — Proxy all outbound traffic through files.com proxy server
  - `endpoint_override` string — Custom site endpoint URL
  - `log_file` string — Log file name and location
  - `log_level` string — Log level for the agent logs ['debug', 'info', 'warn', 'error', 'fatal'] (default info)
  - `log_rotate_num` integer — Log route for agent logs. (default 5)
  - `log_rotate_size` integer — Log route size in MB for agent logs. (default 20)
  - `override_max_concurrent_jobs` integer — Maximum number of concurrent jobs (default 500)
  - `graceful_shutdown_timeout` integer — Graceful shutdown timeout in seconds (default 15)
  - `transfer_rate_limit` string — File transfer (upload/download) rate limit `<limit>-<period>`, with the given periods: * 'S': second * 'M': minute * 'H': hour * 'D': day Examples: * 5 requests/second: '5-S' * 10 requests/minute: '10-M' * 1000 requests/hour: '1000-H' * 2000 requests/day: '2000-D'
  - `auto_update_policy` string — Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default always)
  - `api_token` string — Files Agent API Token
  - `port` integer — Incoming port for files agent connections
  - `hostname` string
  - `public_key` string — public key
  - `status` string — either running or shutdown
  - `server_host_key` string
  - `config_version` string — agent config version

## 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/revisions/c6d6f57e6da8/schema)