---
title: "Create Share"
method: POST
path: "/share/albums/{album_id}"
tags: ["Share"]
---

# Create Share

`POST /share/albums/{album_id}`

Issue a share token and make sure the network listener is up.

An album's local lock is deliberately not consulted: locking protects the
album inside PictoPy, while sharing carries its own authorization.

## Path parameters

- `album_id` string, required

## Request body

- CreateShareRequest
  - `expires_in_minutes` integer, nullable

## Response `200`

Successful Response

- CreateShareResponse
  - `success` boolean, required
  - `message` string, required
  - `data` Share, required
    - `token` string, required
    - `album_id` string, required
    - `album_name` string, required
    - `image_count` integer, required
    - `port` integer, required
    - `created_at` string, required
    - `expires_at` string, nullable
    - `urls` ShareUrl[], required
      - `interface` string, required
      - `ip` string, required
      - `url` string, required

## Other responses

- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/aossie-org/apis/pictopy.md) · [All operations](https://skmtc.net/aossie-org/apis/pictopy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aossie-org/pictopy/revisions/a6c11e6b42e4/schema)