---
title: "Generate (or return) a share token for the collection. Idempotent."
method: POST
path: "/v1/collections/{collectionId}/share"
tags: ["Public API v1"]
---

# Generate (or return) a share token for the collection. Idempotent.

`POST /v1/collections/{collectionId}/share`

## Request

- Base URL: `https://api.mynextadventure.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mynextadventure.cloud/v1/collections/{collectionId}/share`
- Auth: API key in header `X-API-Key`

## Path parameters

- `collectionId` string, required

## Response `201`

- CollectionShareTokenV1Dto
  - `shareToken` string, required: Opaque share token. Treat as a credential.

## Other responses

- `404`: Collection not found or not owned by caller.

---

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