pom://site/authoring-context: choose the right authoring path
This should normally be the first resource read for a page-building task. It summarizes the connected site’s editing model and points the client toward the relevant tools and follow-up resources.
What is contextual
The JSON payload describes:
- the target type, ID, and post type, when known;
- whether the target object was found;
- POM Theme availability;
- Classic Builder integration and separate shortcode rendering availability;
- the contextual block palette, editor URL, preferred content format and client serialization requirements;
- layout and styling rules;
- preferred and discouraged shortcode tags;
- archive, single, and feed template contexts;
- related resource URIs;
- recommended read, validation, and write tools;
- common safe workflows.
The resource URI itself has no arguments, so resources/read returns site-level context rather than context for a particular post. When a task concerns one existing object, call pom_get_authoring_context with its target type and ID; that tool can include object-specific findings.
How to act on the result
Read preferred_content_format and the existing source first. For block pages, use pom://site/block-editor and the contextual block tools. If the selected format is shortcodes and builder.available is true, preserve the POM row-and-column hierarchy and read the builder guide. If POM Theme is unavailable, do not invent POM modules or template operations. If a desired shortcode is listed as discouraged, follow the replacement indicated by the current authoring rules rather than reproducing legacy markup.
The recommended tools are guidance, not an execution plan. Select only those needed for the user’s requested outcome. In particular, a returned write-tool name does not bypass the write gate or authorize an unrequested mutation.
Freshness
Authoring context is assembled from the live site. Re-read it after activating or updating the theme, changing modules, switching the target post type, or reconnecting to a different multisite subsite.
Related guides: inspect a site, POM builder resource, and inspect before changing.