shares

Change a share link's scope, password, or expiry

editor+. Sending any read-only field (id, token, page_id, created_by, created_at, revoked_at) is a 400 rather than a silent no-op. A revoked link cannot be edited — create a new one.

patch/api/shares/{share_id}

Request

  • Base URL: https://telawiki.com
  • URL: https://telawiki.com/api/shares/{share_id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie tela_session

Request body

include_descendantsboolean
passwordstring nullable

null or "" removes the password.

expires_atstring nullable

null removes the expiry; a string must be a future YYYY-MM-DD HH:MM:SS.

Response

Updated.

Example response

{
  "share": {
    "created_at": "2026-09-09 14:03:21"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.