revert_staging_site

Roll back a staging site to an earlier version using content and staging site IDs to undo recent changes or restore previous configurations.

Instructions

Revert a staging site to a previous state

Input Schema

TableJSON Schema

Name	Required	Description
`contentSiteId`	Yes	Content site ID
`reason`	No	Reason for reversion
`stagingSiteId`	Yes	Staging site ID

Implementation Reference

src/index.ts:1272-1308 (registration)

Registration of the 'revert_staging_site' tool, including schema and handler function that calls the backend API to revert a staging site.

  "revert_staging_site",
  {
    title: "Revert Staging Site",
    description: "Revert a staging site to a previous state",
    inputSchema: {
      contentSiteId: z.string().describe("Content site ID"),
      stagingSiteId: z.string().describe("Staging site ID"),
      reason: z.string().optional().describe("Reason for reversion"),
    },
  },
  async ({ contentSiteId, stagingSiteId, reason }) => {
    try {
      const payload = { reason };
      const response: AxiosResponse<ApiResponse> = await apiClient.put(`/tools/content-sites/${contentSiteId}/staging-sites/${stagingSiteId}/revert`, payload);

      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response.data, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: handleApiError(error),
          },
        ],
        isError: true,
      };
    }
  }
);

src/index.ts:1283-1306 (handler)

The handler executes the tool logic by making a PUT request to the Headlesshost API endpoint to revert the specified staging site, handling the response or error appropriately.

  try {
    const payload = { reason };
    const response: AxiosResponse<ApiResponse> = await apiClient.put(`/tools/content-sites/${contentSiteId}/staging-sites/${stagingSiteId}/revert`, payload);

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text",
          text: handleApiError(error),
        },
      ],
      isError: true,
    };
  }
}

src/index.ts:1274-1281 (schema)

Input schema defining parameters: contentSiteId (required string), stagingSiteId (required string), reason (optional string). Uses Zod for validation.

  title: "Revert Staging Site",
  description: "Revert a staging site to a previous state",
  inputSchema: {
    contentSiteId: z.string().describe("Content site ID"),
    stagingSiteId: z.string().describe("Staging site ID"),
    reason: z.string().optional().describe("Reason for reversion"),
  },
},

Kapiti MCP Server