# Rename and share

> Rename a task, or share it with a read-only link. Anyone with a share link sees the conversation and every file in it, and nobody can change anything through it.

Canonical URL: https://harnessrouter.ai/docs/rename-and-share-a-session
Section: API reference

## Rename

A title is cut to 120 characters, and an empty one answers 400 with `invalid_title`.

Rename a task:

```
PATCH /v1/sessions/{id}
{"title": "Q4 support summary"}
```

## Share

A share link opens the task read-only: its conversation and every file in its folder, with HTML pages shown as they render. In the console, use the task's share control.

The answer carries `enabled`, `token` and `url`, a path on the console's address such as `/share/<token>`.

Share endpoints:

```
POST   /v1/sessions/{id}/share   turn the link on
GET    /v1/sessions/{id}/share   whether it is on, and its link
POST   /v1/sessions/{id}/share   {"enabled": false} turns it off
DELETE /v1/sessions/{id}/share   turns it off too
```

> **A link is open to anyone who has it.** Share only what the person whose task it is agreed to share. Turning the link off stops it at once.
