---
title: "Changes to Create a share"
method: PUT
path: "/shares"
---

# Changes to Create a share

`PUT /shares`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 57 revisions.

- **2026-07-31** `e8e6b266ea29`: 8 info
- **2026-07-31** `2ff18e50dcc1`: 15 info
- **2026-07-31** `2db906b9afb1`: 1 info

## Changes

- **2026-07-31** `e8e6b266ea29`: 8 info
  - api operation id `shareCreate` was added
  - added optional request body
  - the `query` request parameter `filter` became optional
  - the `query` request parameter `type` became optional
  - added the non-success response with the status `401`
  - 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 `500`
- **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** `2db906b9afb1`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ampache/apis/ampache-rest-api/docs/shares/put.md) - [API](https://skmtc.dev/ampache/apis/ampache-rest-api.md) - [Page](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/shares/put)