---
title: "Create organization install link"
method: POST
path: "/v1/orgs/{organizationId}/install-links"
tags: ["Organizations"]
---

# Create organization install link

`POST /v1/orgs/{organizationId}/install-links`

Mints a shareable OpenWork desktop install link for a signed-in organization member. Older active links remain valid unless an owner or admin explicitly requests rotation.

## Path parameters

- `organizationId` string, required

## Request body

- CreateInstallLinkRequest
  - `rotate` boolean

## Response `200`

Install link created successfully.

- CreateInstallLinkResponse
  - `token` string, required
  - `installPageUrl` string, uri, required

## Other responses

- `400` — The install-link request was invalid.
- `401` — The caller must be signed in to create install links.
- `403` — The organization needs the installLinks capability enabled, and only workspace owners and admins can rotate existing links.
- `404` — The organization could not be found.
- `429` — The member has created too many install links.

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-08-25** `b2451c4deabb` — 2 info
  - removed the `remoteMcpApps` enum value from the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`
  - removed the `workflows` enum value from the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`
- **2026-08-20** `93df40e2efd5` — 1 warning, 1 info
  - added the new `workflows` enum value to the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`
  - removed the `codemodeScripts` enum value from the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`
- **2026-08-17** `d14bc6855848` — 1 warning
  - added the new `remoteMcpApps` enum value to the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`
- **2026-08-10** `54cdbd4ecffa` — 1 warning
  - added the new `codemodeScripts` enum value to the `anyOf[#/components/schemas/CapabilityDisabledError]/capability` response property for the response status `403`

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/orgs/:organizationId/install-links/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/571dc4a74532/schema)