---
title: "Changes to Create a public share URL"
method: POST
path: "/albums/{album_id}/share"
---

# Changes to Create a public share URL

`POST /albums/{album_id}/share`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 57 revisions.

- **2026-07-31** `e8e6b266ea29`: 4 info
- **2026-07-31** `2ff18e50dcc1`: 15 info
- **2026-07-31** `7ed7a764efd9`: 5 info
- **2026-02-26** `c3f202b17eb7`: 1 info
- **2026-02-19** `07f53972fdd7`: 1 breaking

## Changes

- **2026-07-31** `e8e6b266ea29`: 4 info
  - api operation id `shareCreateAlbums` was added
  - added optional request body
  - added the non-success response with the status `401`
  - removed the non-success response with the status `410`
- **2026-07-31** `2ff18e50dcc1`: 15 info
  - added the required property `allow_download` to the response with the `200` status
  - added the required property `allow_stream` to the response with the `200` status
  - added the required property `counter` to the response with the `200` status
  - added the required property `creation_date` to the response with the `200` status
  - added the required property `description` to the response with the `200` status
  - added the required property `expire_days` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `lastvisit_date` to the response with the `200` status
  - added the required property `max_counter` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `object_id` to the response with the `200` status
  - added the required property `object_type` to the response with the `200` status
  - added the required property `owner` to the response with the `200` status
  - added the required property `public_url` to the response with the `200` status
  - added the required property `secret` to the response with the `200` status
- **2026-07-31** `7ed7a764efd9`: 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `410`
  - added the non-success response with the status `500`
- **2026-02-26** `c3f202b17eb7`: 1 info
  - endpoint added
- **2026-02-19** `07f53972fdd7`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/ampache/apis/ampache-rest-api/docs/albums/:album_id/share/post.md) - [API](https://skmtc.dev/ampache/apis/ampache-rest-api.md) - [Page](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/albums/:album_id/share/post)