---
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.

---

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