---
title: "GET /v1/tiles/{workspaceName}/{tileName}/versions"
method: GET
path: "/v1/tiles/{workspaceName}/{tileName}/versions"
tags: ["Tiles"]
---

# GET /v1/tiles/{workspaceName}/{tileName}/versions

`GET /v1/tiles/{workspaceName}/{tileName}/versions`

Lists versions of a tile, with semver and describes filters. Pass `includeArchived=true` to also return archived versions (excluded by default).

## Path parameters

- `workspaceName` string, required
- `tileName` string, required

## Query parameters

- `sort` union
  - union[]
    - union
      - 'version'
      - '-version'
  - 'version'
  - '-version'
- `page[size]` number
- `page[after]` string
- `page[before]` string
- `filter[describes]` string
- `filter[describes][eq]` string
- `filter[describes][ne]` string
- `filter[describes][gt]` string
- `filter[describes][gte]` string
- `filter[describes][lt]` string
- `filter[describes][lte]` string
- `filter[describes][like]` string
- `filter[major]` string
- `filter[major][eq]` string
- `filter[major][ne]` string
- `filter[major][gt]` string
- `filter[major][gte]` string
- `filter[major][lt]` string
- `filter[major][lte]` string
- `filter[major][like]` string
- `filter[minor]` string
- `filter[minor][eq]` string
- `filter[minor][ne]` string
- `filter[minor][gt]` string
- `filter[minor][gte]` string
- `filter[minor][lt]` string
- `filter[minor][lte]` string
- `filter[minor][like]` string
- `filter[patch]` string
- `filter[patch][eq]` string
- `filter[patch][ne]` string
- `filter[patch][gt]` string
- `filter[patch][gte]` string
- `filter[patch][lt]` string
- `filter[patch][lte]` string
- `filter[patch][like]` string
- `includeArchived` boolean

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, uuid, required
    - `type` 'tile-version', required
    - `attributes` object, required
      - `fingerprint` string, required
      - `version` string, required
      - `major` number, required
      - `minor` number, required
      - `patch` number, required
      - `prerelease` string, nullable, required
      - `describes` string, nullable, required
      - `archived` boolean, required
      - `archivedAt` string, date-time, nullable, required
      - `archivedBy` string, uuid, nullable, required
      - `archivedReason` string, nullable, required
      - `docs` string, nullable, required
      - `steering` object, nullable, required
      - `hasSteering` boolean, required
      - `hasSkills` boolean, required
      - `hasDocs` boolean, required
      - `summary` string, required
      - `tesslVerified` boolean, required
      - `moderationStatus` union, required — Aggregate outcome of the moderation pipeline. `pass` means moderation passed; `skipped` means moderation did not run; `pending` means moderation is in progress; `fail` means moderation rejected the version; `error` means moderation could not complete.
        - 'pending'
        - 'pass'
        - 'fail'
        - 'error'
        - 'skipped'
      - `moderationError` string, nullable, required — Reason for non-visible moderation state. Populated for `fail` and `error`. Null for `pass`, `skipped`, and `pending`.
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `evalScore` integer, nullable, required
      - `evalBaselineScore` integer, nullable, required
      - `evalImprovement` integer, nullable, required
      - `evalImprovementMultiplier` number, nullable, required
    - `relationships` object, required
      - `tile` object, required
        - `data` object, required
          - `id` string, uuid, required
          - `type` 'tile', required
        - `links` object, required
          - `self` string, uri, required
    - `links` object, required
      - `self` string, uri, required

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tessl/apis/tessl-api.md) · [All operations](https://skmtc.net/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessl/tessl-api/versions/fbb186825642/schema)