---
title: "Make a link anyone can join the workspace by"
method: POST
path: "/api/workspaces/{id}/share-link"
tags: ["workspaces"]
---

# Make a link anyone can join the workspace by

`POST /api/workspaces/{id}/share-link`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/workspaces/{id}/share-link`
- Auth: HTTP bearer

The workspace owner only. permission: viewer (default) or admin. The link needs a free seat on the owner’s plan now, and each person who joins is checked again. It expires; url is the link to send.

## Path parameters

- `id` string, required

## Request body

- object
  - `permission` 'viewer' | 'admin'

## Response `200`

code, url, permission, expires_at.

## Other responses

- `403`: OWNER_ONLY, or UPGRADE_REQUIRED / SEAT_LIMIT with upgradeTier, upgrade_url and next, as on an invite.
- `429`: Over one of the account's rate limits (rate_limited): `limit` names it, `retry_after` and Retry-After say how many seconds to wait. Limits are per account (the workspace owner when the request acts on a computer or a workspace) and set by its plan (x-rate-limits).

## Changes

- **2026-11-01** `60e768a2bb9d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/workspaces/:id/share-link/post.md)

---

[API](https://skmtc.dev/orgo/apis/orgo-api.md) - [All operations](https://skmtc.dev/orgo/apis/orgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orgo/apis/orgo-api/revisions/e4c1e7379fa5?raw)