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

# Create Share

`POST /studio/share`

## Request

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

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.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)