---
title: "POST /api/dcv/session_sharing/link"
method: POST
path: "/api/dcv/session_sharing/link"
tags: ["Virtual Desktops"]
---

# POST /api/dcv/session_sharing/link

`POST /api/dcv/session_sharing/link`

POST operation for /api/dcv/session_sharing/link

## Headers

- `X-EDH-USER` string, required
- `X-EDH-TOKEN` string, required

## Request body

- object
  - `grant_id` string, required — ID of the active grant to generate a link for

## Response `200`

DCV link generated successfully

- object
  - `success` boolean
  - `message` object
    - `dcv_url` string — Full DCV gateway URL with embedded auth token

## Other responses

- `400` — Missing grant_id
- `403` — Not authorized or link sharing not enabled
- `404` — Grant not found or inactive
- `502` — Failed to obtain connection token from broker
- `503` — Broker unavailable

---

[API](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api.md) · [All operations](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/engineering-development-hub-edh-api/revisions/058396b8f0f1/schema)