---
title: "Changes to Turn sharing on and get the share link — idempotent; {\"access\": \"view\"} asks for a view-only link; {\"rotate\": true} replaces it [write]"
method: POST
path: "/sessions/{id}/share"
---

# Changes to Turn sharing on and get the share link — idempotent; {"access": "view"} asks for a view-only link; {"rotate": true} replaces it [write]

`POST /sessions/{id}/share`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-11-02** `e5e8f0229a99`: 1 breaking, 7 info

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 breaking, 7 info
  - the response property `shareUrl` became optional for the status `200`
  - added the new optional request property `access`
  - added the optional property `access` to the response with the `200` status
  - added the optional property `error/request_id` to the response with the `default` status
  - the response property `error` became required for the status `default`
  - the response property `error/code` became required for the status `default`
  - the response property `error/message` became required for the status `default`
  - added the required property `token` to the response with the `200` status

---

[Operation](https://skmtc.dev/agentsky/apis/agentsky-developer-api/docs/sessions/:id/share/post.md) - [API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [Page](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/share/post)