v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Guidance API

List Guidance 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.

get/v2/guidances/{guidance_id}/versions

Path parameters

guidance_idstring required

The ID of the guidance whose versions to list.

Query parameters

includeUnpublishedDraftsboolean

If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).

If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).

pageSizeinteger

Maximum number of results to return. Default is 1000, maximum is 2000.

Maximum number of results to return. Default is 1000, maximum is 2000.

pageTokenstring

Token for pagination. Leave empty for the first request.

Token for pagination. Leave empty for the first request.

Response

Success

nextPageTokenstring nullable

Token for retrieving the next page of results. Empty if no more results.