---
title: "Get connection info for workspace agent"
method: GET
path: "/api/v2/workspaceagents/{workspaceagent}/connection"
tags: ["Agents"]
---

# Get connection info for workspace agent

`GET /api/v2/workspaceagents/{workspaceagent}/connection`

## Path parameters

- `workspaceagent` string, uuid, required

## Response `200`

OK

- WorkspacesdkAgentConnectionInfo
  - `derp_force_websockets` boolean
  - `derp_map` TailcfgDERPMap
    - `homeParams` TailcfgDERPHomeParams
      - `regionScore` object — RegionScore scales latencies of DERP regions by a given scaling factor when determining which region to use as the home ("preferred") DERP. Scores in the range (0, 1) will cause this region to be proportionally more preferred, and scores in the range (1, ∞) will penalize a region. If a region is not present in this map, it is treated as having a score of 1.0. Scores should not be 0 or negative; such scores will be ignored. A nil map means no change from the previous value (if any); an empty non-nil map can be sent to reset all scores back to 1.0.
    - `omitDefaultRegions` boolean — OmitDefaultRegions specifies to not use Tailscale's DERP servers, and only use those specified in this DERPMap. If there are none set outside of the defaults, this is a noop. This field is only meaningful if the Regions map is non-nil (indicating a change).
    - `regions` object — Regions is the set of geographic regions running DERP node(s). It's keyed by the DERPRegion.RegionID. The numbers are not necessarily contiguous.
  - `disable_direct_connections` boolean
  - `hostname_suffix` string

---

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