---
title: "Share links for a page"
method: GET
path: "/api/pages/{id}/shares"
tags: ["shares"]
---

# Share links for a page

`GET /api/pages/{id}/shares`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/pages/{id}/shares`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `tela_session`

`editor+`.

## Query parameters

- `include_revoked` 'true'

## Response `200`

Share links, newest first.

- object
  - `shares` ShareLink[], required
    - `id` integer, required
    - `token` string, required
    - `page_id` integer, required
    - `include_descendants` boolean, required
    - `has_password` boolean, required: The password itself is never returned.
    - `created_by` integer, required
    - `created_at` string, required: `YYYY-MM-DD HH:MM:SS` in UTC.
    - `expires_at` string, nullable
    - `revoked_at` string, nullable
    - `url` string, required: The link to hand out: `<origin>/share/{token}[/{title-slug}]`.

## Other responses

- `400`: `invalid_id` — a path parameter was not a positive integer.
- `403`: `forbidden` (no access, or the role is too low), `viewer_no_write`, `api_key_scope` (the token's scope forbids this method), or `api_key_space_scope` (the token is pinned to another space).
- `404`: `not_found`.
- `500`: `internal` — server error.

---

[API](https://skmtc.dev/telawiki/apis/tela-rest-api.md) · [All operations](https://skmtc.dev/telawiki/apis/tela-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telawiki/apis/tela-rest-api/revisions/f316f31f6fcb?raw)