ai-platform-changes

Submit and manage editorially approved content change proposals in the REDAXO ai_platform addon.

4|Updated May 27, 2026
One-click install
npx skills add https://github.com/FriendsOfREDAXO/ai_platform --skill ai-platform-changes-friendsofredaxo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-platform-changes
Source: https://github.com/FriendsOfREDAXO/ai_platform/tree/main/.claude/skills/ai-platform-changes
Command: npx skills add https://github.com/FriendsOfREDAXO/ai_platform --skill ai-platform-changes-friendsofredaxo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents and addons often have read-only access to a REDAXO installation but still need to change content. This Skill explains how to submit change proposals (Änderungswünsche) that only take effect after an editor approves them, covering the agent tools, the PHP API, and the REST endpoints. ## Core Features & Use Cases - Three submission paths: Use the agent tools (redaxo_describe_change_types, redaxo_read_current, redaxo_propose_change), the PHP ChangeService, or the seven scoped REST routes under /api/ai_platform/changes. - Six change types: Propose updates, creates, and deletions for slices, articles, categories, metainfo, media (with staged uploads), and YForm datasets, with batching and changesets for grouped approval. - Custom change types: Register new Target, Payload, and Handler classes via the AI_PLATFORM_CHANGE_HANDLERS extension point without touching core files. - Use Case: An SEO agent without write access proposes corrected headings across 40 articles as one changeset; an editor reviews the diff and approves all of them with a single action. ## Quick Start Ask the agent to call redaxo_describe_change_types first, then read the current state of the target and submit a proposal with a clear reason for the editor.

Frequently Asked Questions about ai-platform-changes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit a content change proposal in REDAXO ai_platform?

Call redaxo_describe_change_types first to learn valid types and fields, read the current state with redaxo_read_current, then submit via redaxo_propose_change with type, operation, target, fields, and a reason. From PHP use ChangeService::propose(), or POST to /api/ai_platform/changes over REST.

How do I propose a change via the REDAXO REST API?

Send a POST request to /api/ai_platform/changes with a Bearer token holding the ai_platform/changes/propose scope. The JSON body contains type, operation, target, fields, and reason; batches use a proposals array with an optional top-level changeset key.

Why was my change proposal rejected on submission?

Common causes are unknown field names for the type, undefined metainfo fields, YForm tables not enabled by an admin, modules that execute values as PHP, or references to deleted media, articles, or templates. Run redaxo_describe_change_types to get the valid field list.

Can an agent approve its own change proposals in REDAXO?

Yes, but only if its API token carries the ai_platform/changes/approve scope, granted in the api addon's token settings. Self-approval works only for the token's own pending proposals and cannot override blocked states like broken references.

How do I add an image to a slice through a change proposal?

Stage the file via POST /api/ai_platform/changes/uploads to get a handle and reserved filename, then submit a media create proposal referencing the handle. Only after that media proposal is approved can a slice proposal reference the filename in a media field.

What happens when two proposals target the same REDAXO content?

A second update proposal for the same target marks the earlier open one as superseded rather than merging with it. Create operations are exempt because they address a location, not an existing object, so multiple creates at the same location coexist.