Skip to content

docs: api server commands#222

Open
sriramveeraghanta wants to merge 2 commits intomasterfrom
feat-api-server-commands
Open

docs: api server commands#222
sriramveeraghanta wants to merge 2 commits intomasterfrom
feat-api-server-commands

Conversation

@sriramveeraghanta
Copy link
Member

@sriramveeraghanta sriramveeraghanta commented Feb 26, 2026

Summary by CodeRabbit

Documentation

  • Added new API Server Commands documentation covering comprehensive management guides for the API server, including sections on user management, workspace and project operations, data maintenance, storage, search and indexing, data migration, log management, and marketplace features.

@vercel
Copy link

vercel bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Feb 27, 2026 8:57am

Request Review

@sriramveeraghanta sriramveeraghanta changed the title feat: api server commands docs: api server commands Feb 26, 2026
@coderabbitai
Copy link

coderabbitai bot commented Feb 26, 2026

📝 Walkthrough

Walkthrough

This pull request adds documentation for the Plane API server's Django management commands. A new navigation item is added to the self-hosting sidebar configuration, and a comprehensive documentation page is created detailing command categories, usage examples, and parameter specifications.

Changes

Cohort / File(s) Summary
Navigation Configuration
docs/.vitepress/config.mts
Added "API Server Commands" navigation item under the Manage section in the Self-hosting sidebar, linking to the new documentation page.
Command Documentation
docs/self-hosting/manage/api-server-commands.md
New documentation page providing comprehensive details on all Django management commands available on the Plane API server, organized by categories (User management, Workspace/project operations, Data maintenance, Storage, Search/indexing, Data migration, Log management, Marketplace) with descriptions, usage examples, and parameter tables.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hoppity-hop through the docs we go,
API commands all in a row!
From users to searches, we map them with care,
Self-hosting secrets laid bare!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: api server commands' directly and concisely summarizes the main change: adding documentation for API server commands.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat-api-server-commands

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
docs/self-hosting/manage/api-server-commands.md (2)

120-130: Consider moving test_email to a different section.

The test_email command is about verifying SMTP configuration rather than performing workspace/project operations. It might fit better under a "Configuration" or "Utilities" section, but this is a minor organizational suggestion.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/manage/api-server-commands.md` around lines 120 - 130, Move
the `test_email` command entry out of the workspace/project operations section
and place it under a more appropriate "Configuration" or "Utilities" section in
the docs; update the section heading and any table of contents references to
reflect the move, and ensure the command name `test_email`, example usage
(`python manage.py test_email recipient@example.com`) and the argument row for
`to_email` remain unchanged so the content and invocation stay correct.

280-312: Consider documenting expected input format for age threshold.

All four log deletion commands mention they "prompt interactively for the age threshold" but don't specify what format the age should be in (e.g., days, ISO date, etc.). This would help users prepare the correct input.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/manage/api-server-commands.md` around lines 280 - 312,
Update the documentation for the four management commands (hard_delete_api_logs,
hard_delete_email_notification_logs, hard_delete_recent_visits,
hard_delete_webhook_log) to state the expected age-threshold input format(s) and
show examples; explicitly list accepted units (e.g., integer days), any accepted
date formats (e.g., ISO YYYY-MM-DD), whether relative formats like "30d" or "2
weeks" are supported, what the default behavior is if input is empty or invalid,
and any validation rules or error messages users will see so callers know how to
prepare the input.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/self-hosting/manage/api-server-commands.md`:
- Around line 120-130: Move the `test_email` command entry out of the
workspace/project operations section and place it under a more appropriate
"Configuration" or "Utilities" section in the docs; update the section heading
and any table of contents references to reflect the move, and ensure the command
name `test_email`, example usage (`python manage.py test_email
recipient@example.com`) and the argument row for `to_email` remain unchanged so
the content and invocation stay correct.
- Around line 280-312: Update the documentation for the four management commands
(hard_delete_api_logs, hard_delete_email_notification_logs,
hard_delete_recent_visits, hard_delete_webhook_log) to state the expected
age-threshold input format(s) and show examples; explicitly list accepted units
(e.g., integer days), any accepted date formats (e.g., ISO YYYY-MM-DD), whether
relative formats like "30d" or "2 weeks" are supported, what the default
behavior is if input is empty or invalid, and any validation rules or error
messages users will see so callers know how to prepare the input.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0af57c1 and c82876e.

📒 Files selected for processing (2)
  • docs/.vitepress/config.mts
  • docs/self-hosting/manage/api-server-commands.md

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant