Skip to content

Feature request: full REST API parity for postiz-agent CLI #5

Description

@zitongcharliedeng

Problem

The postiz-agent CLI currently covers a subset of the Postiz REST API:

  • ✅ posts:create, posts:list, posts:delete, posts:missing, posts:connect
  • ✅ integrations:list, integrations:settings, integrations:trigger
  • ✅ upload, analytics:platform, analytics:post
  • ❌ Cannot create/connect integrations (channels)
  • ❌ Cannot manage profiles/bios programmatically
  • ❌ Cannot update integration settings
  • ❌ No workspace/team management

This means AI agents (Claude, Codex, etc.) using the CLI cannot fully manage a Postiz instance without falling back to raw HTTP or the web UI.

Proposal

Add CLI commands for every REST API endpoint, particularly:

  • integrations:create / integrations:delete — manage channels programmatically
  • profile:update — update bios/avatars where platform APIs allow it
  • settings:update — modify integration settings

Motivation

Self-hosted Postiz users running headless NixOS systems (no desktop browser readily available) benefit from full CLI coverage. The official postiz-agent is the right place for this — community MCP wrappers (antoniolg/postiz-mcp, oculairmedia/postizz-MCP) are filling the gap but fragmenting the ecosystem.

Full CLI parity would make postiz-agent THE canonical programmatic interface.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions