> For the complete documentation index, see [llms.txt](https://diffio.ai/llms.txt). This page is also available as HTML at https://diffio.ai/docs/overview/concepts/shares/.

# Shares: public links to a result

A share gives a project a public `id`; `GET /shares/{share_id}` answers anyone holding it, with no API key. It plays one finished generation (the newest, or one you pin) and never the uploaded original. Revoke it to turn it off.

## How it works

1. `not shared`: a new project
2. `published`: `PUT …/share`; the `id` stays the same when you publish again
3. `revoked`: `DELETE …/share`; the id answers `404 share_not_found`

- from `published`: `new version`, a changed `generation_id` or `preview_seconds`: earlier URLs stop

**A project's share. Deleting the project revokes it too.**

## Limits

| Limit | Value |
| --- | --- |
| Share id | 17 characters |
| `preview_seconds` | 4 to 3600, rounded up to whole 4 second segments |
| Old URLs after a revoke or change | stop within about a minute |
| API key | not needed for `GET /shares/{share_id}`; any origin may call it |
| Files | the shared generation's playback files; never `original` |

## Build with it

- Guide [Share a restored result](https://diffio.ai/docs/developers/guides/share-a-result/)

- [`PUT /projects/{project_id}/share`](https://diffio.ai/docs/api-reference/publish-project-share/)
- [`GET /projects/{project_id}/share`](https://diffio.ai/docs/api-reference/get-project-share/)
- [`DELETE /projects/{project_id}/share`](https://diffio.ai/docs/api-reference/revoke-project-share/)
- [`GET /shares/{share_id}`](https://diffio.ai/docs/api-reference/get-share/)

## Related pages

- Previous: [Separated tracks](https://diffio.ai/docs/overview/concepts/separated-tracks/): Each restore separates speech from background; save a balance of the two and render it as a downloadable export.
- Next: [End users](https://diffio.ai/docs/overview/concepts/end-users/): Send Diffio-End-User with each request to keep every customer's projects, usage and events apart under one API key.
