---
title: "Changes to Create a share token"
method: POST
path: "/api/preview/share"
---

# Changes to Create a share token

`POST /api/preview/share`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 12 revisions.

- **2026-10-27** `3a2c4ebeab51`: 1 info
- **2026-10-09** `c7729725d527`: 23 info
- **2026-09-12** `74a5f960149b`: 1 warning

## Changes

- **2026-10-27** `3a2c4ebeab51`: 1 info
  - added the optional property `shareToken/share_url_unavailable_reason` to the response with the `201` status
- **2026-10-09** `c7729725d527`: 23 info
  - added the new optional request property `new`
  - added the new `project` enum value to the request property `resourceType`
  - added the optional property `exposes_capsules` to the response with the `201` status
  - added the optional property `shareToken/expires_at` to the response with the `201` status
  - added the optional property `shareToken/max_views` to the response with the `201` status
  - added the optional property `shareToken/resource_path` to the response with the `201` status
  - added the optional property `shareToken/resource_title` to the response with the `201` status
  - added the optional property `shareToken/revoked_at` to the response with the `201` status
  - added the required property `reused` to the response with the `201` status
  - added the required property `shareToken/created_at` to the response with the `201` status
  - added the required property `shareToken/id` to the response with the `201` status
  - added the required property `shareToken/is_active` to the response with the `201` status
  - added the required property `shareToken/is_live` to the response with the `201` status
  - added the required property `shareToken/listing` to the response with the `201` status
  - added the required property `shareToken/permission` to the response with the `201` status
  - added the required property `shareToken/primary` to the response with the `201` status
  - added the required property `shareToken/resource_id` to the response with the `201` status
  - added the required property `shareToken/resource_type` to the response with the `201` status
  - added the required property `shareToken/share_url` to the response with the `201` status
  - added the required property `shareToken/state` to the response with the `201` status
  - added the required property `shareToken/token_preview` to the response with the `201` status
  - added the required property `shareToken/view_count` to the response with the `201` status
  - added the required property `share_url` to the response with the `201` status
- **2026-09-12** `74a5f960149b`: 1 warning
  - changed the pattern of the request property `expiresAt` from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$`

---

[Operation](https://skmtc.dev/symbol/apis/symbol-api/docs/api/preview/share/post.md) - [API](https://skmtc.dev/symbol/apis/symbol-api.md) - [Page](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/share/post)