> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # List version history of a canvas > Returns a paginated, lightweight list of a canvas's versions ordered from newest to oldest. Items carry lifecycle metadata (`draft`, `promoted`, `originVersionId`, environments, `versionIndex`) but not the prompt content or configuration; fetch `GET /prompt-version/{id}` for the full version. ## OpenAPI ````yaml GET /prompt-version/history openapi: 3.0.1 info: title: Tela API license: name: MIT version: 1.0.0 servers: - url: https://api.tela.com security: [] paths: /prompt-version/history: get: tags: - Prompt Version summary: List version history of a canvas description: > Returns a paginated, lightweight list of a canvas's versions ordered from newest to oldest. Items carry lifecycle metadata (`draft`, `promoted`, `originVersionId`, environments, `versionIndex`) but not the prompt content or configuration; fetch `GET /prompt-version/{id}` for the full version. Pagination uses `limit` (default 20, max 100) and `offset`. This replaces the deprecated `GET /prompt-version?promptId=` listing. parameters: - name: promptId in: query required: true description: Canvas id. schema: type: string format: uuid - name: limit in: query required: false description: Page size. Defaults to 20; values are clamped to the range 1-100. schema: type: string - name: offset in: query required: false description: Number of items to skip. Defaults to 0. schema: type: string - name: objectLinks in: query required: false description: >- When `true`, `meta.links` entries are returned as query-parameter objects instead of query strings. schema: type: string responses: '200': description: A page of version history items. content: application/json: schema: $ref: '#/components/schemas/VersionHistoryResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: >- Missing or invalid credentials, or no access to the canvas's project. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- The project exists in the workspace but the caller's team has no access to it. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Canvas not found (or a personal draft owned by someone else). content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: >- Query parameters failed validation (for example a missing `promptId`). content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: VersionHistoryResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/VersionHistoryItem' meta: $ref: '#/components/schemas/VersionPaginationMeta' required: - data - meta example: data: - id: 9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f promptId: 5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12 title: v12 - stricter totals promoted: true draft: false originVersionId: 8c1d3e5f-0a2b-4c4d-9e6f-0a1b2c3d4e5f createdBy: ana@example.com updatedBy: ana@example.com createdAt: '2026-08-19T09:41:00.000Z' updatedAt: '2026-08-19T09:41:00.000Z' environments: - id: 3e4f5a6b-7c8d-4e9f-8a0b-1c2d3e4f5a6b name: production isSystem: true publishedAt: '2026-08-19T10:00:00.000Z' versionIndex: 12 originVersionIndex: 11 - id: 8c1d3e5f-0a2b-4c4d-9e6f-0a1b2c3d4e5f promptId: 5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12 title: v11 promoted: false draft: false originVersionId: null createdBy: ana@example.com updatedBy: ana@example.com createdAt: '2026-08-10T08:00:00.000Z' updatedAt: '2026-08-10T08:00:00.000Z' environments: [] versionIndex: 11 originVersionIndex: null meta: totalCount: 12 limit: 20 offset: 0 currentPage: 1 totalPages: 1 links: first: '?promptId=5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12&limit=20&offset=0' last: '?promptId=5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12&limit=20&offset=0' next: null previous: null Error: {} VersionHistoryItem: type: object properties: id: type: string format: uuid promptId: type: string format: uuid title: type: string promoted: type: boolean nullable: true draft: type: boolean nullable: true originVersionId: type: string format: uuid nullable: true createdBy: type: string updatedBy: type: string createdAt: type: string format: date-time nullable: true updatedAt: type: string format: date-time nullable: true environments: type: array items: $ref: '#/components/schemas/VersionEnvironment' versionIndex: type: integer description: 1-based position among the canvas's versions (1 is the oldest). originVersionIndex: type: integer nullable: true description: >- `versionIndex` of `originVersionId`, or `null` when there is no origin. required: - id - promptId - title - promoted - draft - originVersionId - createdBy - updatedBy - createdAt - updatedAt - versionIndex VersionPaginationMeta: type: object properties: totalCount: type: integer limit: type: integer offset: type: integer currentPage: type: integer totalPages: type: integer lastReference: type: integer links: type: object description: >- Query strings (or objects when `objectLinks=true`) for the first, last, next and previous pages. properties: first: oneOf: - type: string - type: object additionalProperties: true last: oneOf: - type: string - type: object additionalProperties: true next: nullable: true oneOf: - type: string - type: object additionalProperties: true previous: nullable: true oneOf: - type: string - type: object additionalProperties: true required: - first - last - next - previous required: - totalCount - limit - offset - currentPage - totalPages - links VersionEnvironment: type: object description: An environment the version is currently published to. properties: id: type: string format: uuid name: type: string description: Environment name, for example `production`. isSystem: type: boolean description: '`true` for the built-in `production` environment.' publishedAt: type: string format: date-time required: - id - name - isSystem - publishedAt securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT or UUID ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.