---
title: "Create Share"
method: POST
path: "/v1/share/create"
tags: ["share"]
---

# Create Share

`POST /v1/share/create`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/share/create`
- Auth: HTTP bearer

Create a share link for a conversation.

- **conversation_id**: The conversation to share
- **share_type**: 'canvas_only' (default) or 'full_conversation'
- **expires_in_days**: Days until expiration (null = never expires)

Returns the share token and full URL.

## Request body

- CreateShareRequest: Request to create a share link for a conversation
  - `conversation_id` string, required: The conversation ID to share
  - `share_type` 'canvas_only' | 'full_conversation': Type of content to share
  - `expires_in_days` integer, nullable: Number of days until link expires (None = never)
  - `base_url` string, nullable: Base URL for the share link (e.g., http://localhost:5173)
  - `canvas_version` integer, nullable: Specific canvas version to share (None = current/latest)

## Response `200`

Successful Response

- ShareResponse: Response after creating a share
  - `share_token` string, required: The unique share token
  - `share_url` string, required: Full URL for sharing
  - `share_type` string, required: Type of share (canvas_only or full_conversation)
  - `expires_at` string, date-time, nullable: Expiration timestamp
  - `created_at` string, date-time, required: Creation timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)