pushword / api

1.0.5 2026-09-13 15:09 UTC

Requires

• pushword/core: *
• pushword/flat: *

Suggests

• pushword/admin: Manage pages, media and users from an EasyAdmin-based back-office.
• pushword/admin-block-editor: Rich block editor (EditorJS) for the admin.
• pushword/advanced-main-image: Choose the main image format per page, from hidden to full hero.
• pushword/conversation: Add comments, a contact form or any user input to your website.
• pushword/docs: Pushword documentation, readable offline from vendor/.
• pushword/link-improver: Automatic internal links: page names become in-content links at render time.
• pushword/newsletter: Audiences, segmented campaigns and criteria-driven automations.
• pushword/page-scanner: Find dead links, 404s, redirects and TODO reminders.
• pushword/page-update-notifier: Get an email when a page is created or edited.
• pushword/quiz: Interactive client-side quizzes (QCM) and personality tests.
• pushword/repurpose: Turn a page into ready-to-post social carousels (PNG/PDF).
• pushword/search: SQLite-native full-text search via Loupe, zero infrastructure.
• pushword/snippet: Reusable content fragments and dev-registered Twig components.
• pushword/static-generator: Export the whole site as static files (GitHub Pages, Apache, FrankenPHP).
• pushword/template-editor: Edit Twig view files online from the admin.
• pushword/version: Keep a version history of your pages and compare revisions.

MIT

• Robin@PiedWeb

• symfony
• rest
• api
• openapi
• headless-cms
• content-api
• pushword

Published on Packagist.org on 2026-09-13 20:09 UTC

README

Token-authenticated REST API mirroring the Pushword admin — manage Pages, Media and redirections programmatically, with an OpenAPI description.

Features

• REST endpoints for Page, Media and page redirections.
• Bearer-token auth against the User apiToken (pw:user:token to fetch one).
• OpenAPI-described, machine-readable docs endpoint.
• Built for scripted workflows and external tooling (CI, headless editing).

Installation

composer require pushword/api

Documentation

Visit pushword.piedweb.com/extension/api and media-api.

The Pushword ecosystem

Pushword is a modular CMS — one Symfony bundle for the core and one bundle per feature. Pick only what you need:

Core

• pushword/core — Symfony-based CMS core: Page, Media & User entities, Markdown + Twig rendering.

Editing & admin

• pushword/admin — EasyAdmin interface to manage pages, media and users.
• pushword/admin-block-editor — Gutenberg-like block editor (stores Markdown).
• pushword/advanced-main-image — Hero images & main-image format control.
• pushword/template-editor — Edit Twig templates online.
• pushword/snippet — Reusable content fragments & components.

Content & workflow

• pushword/flat — Flat-file (Markdown + Git) CMS mode.
• pushword/version — Page & snippet versioning.
• pushword/page-update-notifier — Email alerts on content changes.
• pushword/conversation — Comments, contact & newsletter forms.

Publishing & performance

• pushword/static-generator — Export a static website (GitHub Pages, Apache, FrankenPHP).
• pushword/search — SQLite full-text search (Loupe), zero infra.
• pushword/page-scanner — Find dead links, 404s, redirects & TODOs.
• pushword/api — Token-authenticated REST API. (this package)

Tooling

• pushword/installer — Project & package installer.
• pushword/js-helper — Front-end JavaScript helpers.

Full list and guides on pushword.piedweb.com/extensions.

Contributing

If you're interested in contributing to Pushword, please read our contributing docs before submitting a pull request.

Credits

• PiedWeb
• All Contributors

License

The MIT License (MIT). Please see License File for more information.