---
title: "Generate Share Link"
method: POST
path: "/api/v1/project/{project_id}/share"
tags: ["project"]
---

# Generate Share Link

`POST /api/v1/project/{project_id}/share`

Generate a share link for a project (idempotent).

If an active share link already exists, returns it. Otherwise creates
a new one with a unique token. Requires write access to the project.

Args:
    project_id: UUID of the project (validated for write access)
    share_service: ProjectShareService for share link operations

Returns:
    Share link details including full URL, token, and status

## Response `200`

Successful Response

- ShareLinkResponse — Response containing share link details for a project owner.
  - `share_url` string, required
  - `share_token` string, required
  - `is_active` boolean, required
  - `view_count` integer, required
  - `created_at` string, date-time, nullable

---

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