> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/system/share_link.md).

# /share\_link

Shortens url paths and generates an url friendly share id to be accessed via /share/\<share\_id>.

* The creating user is stored alongside with the share link. If that user is archived the system user `system:deleted_user`.
* There is no API to revoke an existing share link.
* Share links are removed only after they expire.

### `POST /system/share_link`

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/system/share\_link" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-ca0ed768cf0f36ca55fc3ee2ac61892ce5444d46%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /system/share_link/{id}`

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/system/share\_link/{id}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-ca0ed768cf0f36ca55fc3ee2ac61892ce5444d46%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}