Skill: List Sites

The List Sites skill returns a list of all websites that the calling user has created through Horizon. Agents use this skill when users ask to see their sites, need to find a specific site’s ID for updating, or want to review what they have published.

Parameters

This skill has no required parameters. It automatically scopes results to the authenticated user.

Parameter	Type	Required	Description
(none)	—	—	This skill takes no parameters. All sites belonging to the calling user are returned.

Example usage

A user might trigger this skill by saying:

“What websites have I created?”

or:

“Show me a list of my sites.”

or indirectly:

“I want to update one of my sites but I don’t remember the name.”

In all these cases, the agent invokes List Sites with no parameters. The returned list gives the agent the site IDs, names, and URLs needed to help the user identify the correct site.

Chaining with Update Site

A common pattern is to use List Sites to find a site ID, then pass it to Update Site:

User says: “Update the hero image on my portfolio site.”
Agent calls List Sites to find the site named “Portfolio.”
Agent calls Update Site in fetch mode with the discovered site_id.
Agent applies changes and calls Update Site in update mode.

Response structure

The skill returns a JSON object containing an array of site objects:

{
  "sites": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Bean & Brew Landing Page",
      "url": "https://sites.horizon.app/a1b2c3d4/index.html",
      "created_at": "2026-03-15T10:00:00Z"
    },
    {
      "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "name": "Portfolio Site",
      "url": "https://sites.horizon.app/f9e8d7c6/index.html",
      "created_at": "2026-03-10T08:30:00Z"
    }
  ],
  "total_count": 2
}

Each site object contains:

id — the unique site identifier, used as site_id in other Web skills.
name — the human-readable name assigned during creation.
url — the public URL where the site is hosted.
created_at — ISO 8601 timestamp of when the site was created.

Behavior notes

Ordering — sites are returned in reverse chronological order (newest first).
No pagination — the skill returns all sites for the user in a single response. If a user has a very large number of sites, the response may be sizable, but there is no pagination mechanism.
Deleted sites — sites that have been deleted are not included in the response.
Empty results — if the user has not created any sites, the sites array is empty and total_count is 0. The agent should handle this gracefully by letting the user know they have no sites yet and offering to create one.

API endpoint

POST /api/web/v1.0/list-sites

See the Skill Execution API for details on authentication and request format.

Related skills: Create Site | Update Site | Retrieve Site