---
title: "List Guidance Versions"
method: GET
path: "/v2/guidances/{guidance_id}/versions"
tags: ["Guidance API"]
---

# List Guidance Versions

`GET /v2/guidances/{guidance_id}/versions`

List the version history of a guidance (Help Desk Skill). By default returns only published versions (newest first). Each version carries its own id, name, description, content, author, and publish timestamp — use this to answer what changed in a skill and when. Pass include_unpublished_drafts=true to also include unpublished drafts.

## Path parameters

- `guidance_id` string, required — The ID of the guidance whose versions to list.

## Query parameters

- `includeUnpublishedDrafts` boolean — If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).
- `pageSize` integer — Maximum number of results to return. Default is 1000, maximum is 2000.
- `pageToken` string — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvflowPublicapiListGuidanceVersionsResponse
  - `data` SvflowPubapimodelsGuidanceVersion[] — The list of guidance versions, newest first.
    - `id` string — The ID of this guidance version.
    - `guidanceId` string — The ID of the guidance this version belongs to.
    - `name` string — Guidance name at this version (can differ across versions).
    - `description` string — TRIGGER condition at this version — when the help desk agent should invoke this skill.
    - `content` string — BEHAVIOR instructions at this version — how the help desk agent should handle the situation when this skill fires.
    - `createdByUserId` string — User who created this version.
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `publishedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `isPublished` boolean — Whether this version has ever been published.
  - `nextPageToken` string, nullable — Token for retrieving the next page of results. Empty if no more results.

## Other responses

- `default` — Error

---

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