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

---

[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/073bc652adfb/schema)