---
title: "Read desktop-policies by stable key"
method: GET
path: "/v1/desktop-policies/by-key/{externalKey}"
tags: ["Desktop Policies"]
---

# Read desktop-policies by stable key

`GET /v1/desktop-policies/by-key/{externalKey}`

Reads the desktop policy identified by the stable externalKey assigned through declarative provisioning.

## Path parameters

- `externalKey` string, required

## Response `200`

Resource configuration.

- DesktopPolicyResponse
  - `desktopPolicy` object, required

## Other responses

- `404` — Resource not found.

## Changes

- **2026-09-11** `bb8ff73e4ad3` — 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `denApiKey` was added to the API
- **2026-09-05** `cb34559d4b4d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/desktop-policies/by-key/:externalKey/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) · [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/6117f1cac9d7?raw)