---
title: "Create Share"
method: POST
path: "/studio/share"
tags: ["AI_STUDIO", "SHARE"]
---

# Create Share

`POST /studio/share`

Create a new share link for a playground session.

- **session_id**: The session to share
- **access_type**: 'anyone' (public) or 'specific_people' (restricted)
- **expires_in_days**: Optional expiration (1-365 days)
- **user_ids**: Required for 'specific_people' access type
- **title**: Optional title for the share link

## Request body

- ShareLinkCreateRequest — Request to create a new share link.
  - `session_id` string, required — Session ID to share
  - `access_type` 'anyone' | 'specific_people' | 'all_altimate_users' | 'team' — Access type for share links.
  - `expires_in_days` integer, nullable — Number of days until expiration. None = never expires
  - `user_ids` integer[], nullable — User IDs allowed to access (only for 'specific_people' access type)
  - `team_ids` integer[], nullable — Team (UserGroup) IDs allowed to access (only for 'team' access type)
  - `title` string, nullable — Optional title for the share link

## Response `201`

Successful Response

- ShareLinkResponse — Response containing share link details.
  - `id` string, uuid, required
  - `session_id` string, required
  - `access_type` 'anyone' | 'specific_people' | 'all_altimate_users' | 'team', required — Access type for share links.
  - `expires_at` string, date-time, nullable, required
  - `created_by` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `title` string, nullable, required
  - `share_url` string, required
  - `allowed_users` integer[], nullable
  - `allowed_teams` integer[], nullable

## Other responses

- `422` — Validation Error

---

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