server/cmd/mmctl/docs/mmctl_report_posts.rst
.. _mmctl_report_posts:
Retrieve posts for reporting purposes
Synopsis
Retrieve posts from a channel for reporting purposes. This command supports
pagination and can filter posts by time range. Results can be output in JSON format
for further processing.
::
mmctl report posts [channel] [flags]
Examples
::
# Get posts from a channel with default settings
mmctl report posts myteam:mychannel
# Get posts with JSON output
mmctl report posts myteam:mychannel --json
# Get posts sorted by update_at in descending order
mmctl report posts myteam:mychannel --time-field update_at --sort-direction desc
# Get posts including deleted posts and metadata
mmctl report posts myteam:mychannel --include-deleted --include-metadata
# Get posts excluding ALL system posts
mmctl report posts myteam:mychannel --exclude-system-posts
# Get more posts per page (max 1000)
mmctl report posts myteam:mychannel --per-page 500
# Resume pagination from a specific cursor (use next_cursor from previous response)
mmctl report posts myteam:mychannel --cursor "MTphYmMxMjM6Y3JlYXRlX2F0OmZhbHNlOmZhbHNlOmFzYzoxNjQwMDAwMzAwMDAwOnBvc3Qz"
Options
::
--cursor string Opaque cursor for pagination (use next_cursor from previous response)
--exclude-system-posts Exclude ALL system posts (any type starting with 'system_')
-h, --help help for posts
--include-deleted Include deleted posts
--include-metadata Include file info, reactions, etc.
--per-page int Number of posts per page (max 1000) (default 100)
--sort-direction string Sort direction (asc or desc) (default "asc")
--time-field string Time field to use for sorting (create_at or update_at) (default "create_at")
Options inherited from parent commands
::
--config string path to the configuration file (default "$XDG_CONFIG_HOME/mmctl/config")
--disable-pager disables paged output
--insecure-sha1-intermediate allows to use insecure TLS protocols, such as SHA-1
--insecure-tls-version allows to use TLS versions 1.0 and 1.1
--json the output format will be in json format
--local allows communicating with the server through a unix socket
--quiet prevent mmctl to generate output for the commands
--strict will only run commands if the mmctl version matches the server one
--suppress-warnings disables printing warning messages
SEE ALSO
* `mmctl report <mmctl_report.rst>`_ - Reporting commands