Skip to main content
The Pages API provides endpoints to list and retrieve single pages (standalone content pages) in your Halo CMS.

​
List Single Pages

Retrieves a paginated list of published single pages. 
curl -X GET "http://localhost:8091/apis/api.content.halo.run/v1alpha1/singlepages?page=0&size=10" \
  -H "Accept: application/json"

​
Query Parameters

​
page
integer
default:"0"
Page number. Default is 0.
​
size
integer
default:"0"
Size number. Default is 0.
​
labelSelector
array
Label selector. e.g.: hidden!=true
​
fieldSelector
array
Field selector. e.g.: metadata.name==halo
​
sort
array
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

​
Response

Returns a ListedSinglePageVoList object containing paginated page results.
​
items
array
Array of single page objects.
​
metadata
Metadata
required
Page metadata including name, labels, and timestamps.
​
spec
SinglePageSpec
Page specification.
​
title
string
required
Page title.
​
slug
string
required
Page slug for URL.
​
cover
string
Cover image URL.
​
allowComment
boolean
default:"true"
Whether comments are allowed.
​
pinned
boolean
default:"false"
Whether the page is pinned.
​
priority
integer
default:"0"
Page priority for ordering.
​
visible
string
default:"PUBLIC"
Visibility setting: PUBLIC, INTERNAL, or PRIVATE.
​
publishTime
string
Publication timestamp.
​
status
SinglePageStatus
Page status information.
​
permalink
string
Permanent link to the page.
​
excerpt
string
Page excerpt.
​
commentsCount
integer
Number of comments.
​
stats
StatsVo
Page statistics.
​
visit
integer
Number of visits.
​
upvote
integer
Number of upvotes.
​
comment
integer
Number of comments.
​
owner
ContributorVo
Page owner information.
​
contributors
array
Array of contributor objects.
​
page
integer
Current page number, starts from 1.
​
size
integer
Size of each page.
​
total
integer
Total number of single pages.
​
totalPages
integer
Total number of pages.
​
first
boolean
Whether this is the first page.
​
last
boolean
Whether this is the last page.
​
hasNext
boolean
Whether there is a next page.
​
hasPrevious
boolean
Whether there is a previous page.

​
Get Single Page by Name

Retrieves a single page by its name. 
curl -X GET "http://localhost:8091/apis/api.content.halo.run/v1alpha1/singlepages/{name}" \
  -H "Accept: application/json"

​
Path Parameters

​
name
string
required
SinglePage name (unique identifier).

​
Response

Returns a SinglePageVo object with complete page details including content.
​
metadata
Metadata
required
Page metadata.
​
spec
SinglePageSpec
Page specification.
​
status
SinglePageStatus
Page status.
​
content
ContentVo
Page content.
​
raw
string
Raw content (markdown/HTML).
​
content
string
Rendered content.
​
stats
StatsVo
Page statistics.
​
owner
ContributorVo
Page owner.
​
contributors
array
Page contributors.

Build docs developers (and LLMs) love

Get started for freeTalk to us