---
title: "Preview desktop connection"
method: POST
path: "/v1/install-connect/preview"
tags: ["Organizations"]
---

# Preview desktop connection

`POST /v1/install-connect/preview`

Resolves a short-lived organization connection code without consuming it.

## Request body

- object
  - `code` string, required

## Response `200`

Desktop connection resolved successfully.

- DesktopConnectGrantResponse
  - `claims` ConnectLinkClaims, required
    - `iss` string, uri, required
    - `aud` 'openwork-desktop-connect', required
    - `iat` integer, required
    - `exp` integer, required
    - `jti` string, required
    - `v` 1, required
    - `org` object, required
      - `name` string, required
    - `brand` object, required
      - `appName` string, required
      - `logoUrl` string, uri, nullable, required
      - `iconUrl` string, uri, nullable, required
    - `den` object, required
      - `baseUrl` string, uri, required
      - `apiBaseUrl` string, uri, nullable
    - `requireSignin` boolean, required

## Other responses

- `400` — The connection code body was invalid.
- `404` — The connection code was not found.
- `409` — The connection code was already consumed.
- `410` — The connection code expired.
- `429` — Too many connection attempts.

## Changes

- **2026-09-04** `d3984673ccd1` — 1 info
  - added the optional property `capability` to the response with the `400` status

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/install-connect/preview/post.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-service-production.skmtc.workers.dev/v1/apis/openworklabs/den-api/revisions/d3984673ccd1/schema)