---
title: "A preview room's version and its neighbours"
method: GET
path: "/{id}/versions"
---

# A preview room's version and its neighbours

`GET /{id}/versions`

## Request

- Base URL: `https://marklayer.app/api`
- URL: `https://marklayer.app/api/{id}/versions`
- Auth: none declared

## Path parameters

- `id` string, required: Unguessable share id (nanoid/uuid) — it is the access token

## Response `200`

Version info

- Versions
  - `title` string, nullable, required
  - `note` string, nullable, required
  - `repo` string, nullable, required
  - `branch` string, nullable, required
  - `sha` string, nullable, required
  - `version` number, nullable, required
  - `previous` object, nullable, required
    - `id` string, required
    - `version` number, nullable, required
    - `sha` string, nullable, required
  - `next` object, nullable, required
    - `id` string, required
    - `version` number, nullable, required
    - `sha` string, nullable, required

## Other responses

- `401`: Password-protected link: send `Authorization: Bearer <password>`
- `404`: Not found
- `429`: Too many wrong passwords for this link from this client

---

[API](https://skmtc.dev/marklayer/apis/marklayer-share-api.md) · [All operations](https://skmtc.dev/marklayer/apis/marklayer-share-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marklayer/apis/marklayer-share-api/revisions/0d8cd55afad9?raw)