Skip to content

[DOCSW-615] docs: refresh API reference and add new endpoints#245

Open
iam-vipin wants to merge 4 commits intomasterfrom
refactor-update_developer_docs
Open

[DOCSW-615] docs: refresh API reference and add new endpoints#245
iam-vipin wants to merge 4 commits intomasterfrom
refactor-update_developer_docs

Conversation

@iam-vipin
Copy link
Member

@iam-vipin iam-vipin commented Mar 16, 2026

Description

The update includes a full pass across docs/api-reference/ to normalize endpoint paths, path parameter names, request/response examples, scopes, and status codes to the latest schema-backed format already used in the docs site.

Key changes included in this PR:

  • Added the missing API reference groups and endpoint pages for assets, project labels, workspace features, project features, workspace invitations, milestones, work item pages, project member CRUD, advanced search, work item property values, work item type schema, work item create, and work item properties.
  • Updated existing API reference families including project, state, label, issue/work item, links, activity, comments, attachments, issue types, cycle, module, page, members, user, worklogs, epics, initiative, customer, teamspace, sticky, intake issue, and inbox issue.
  • Normalized docs to modern route families such as /work-items/, /work-item-types/, and /project-members/, and corrected path placeholder usage to match the literal routes shown in the schema and local API.
  • Reworked request and response examples to use sanitized professional sample values rather than copied live data.
  • Updated the API reference sidebar in docs/.vitepress/config.mts so all newly added pages are discoverable in navigation.
  • Added the missing workspaces.members:write scope to docs/dev-tools/build-plane-app/oauth-scopes.md.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

image
Screen.Recording.2026-03-16.at.6.14.33.PM.mov

References

  • Local source contract: schema.yml

@vercel
Copy link

vercel bot commented Mar 16, 2026

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

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Mar 17, 2026 0:33am

Request Review

@coderabbitai
Copy link

coderabbitai bot commented Mar 16, 2026

Important

Review skipped

Too many files!

This PR contains 216 files, which is 66 over the limit of 150.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9eeda7c1-d15d-4c1e-8e74-01a3d4ba3f56

📥 Commits

Reviewing files that changed from the base of the PR and between 97c6ad4 and df76ea2.

📒 Files selected for processing (216)
  • docs/.vitepress/config.mts
  • docs/api-reference/assets/create-user-asset-upload.md
  • docs/api-reference/assets/create-workspace-asset-upload.md
  • docs/api-reference/assets/delete-user-asset.md
  • docs/api-reference/assets/get-workspace-asset.md
  • docs/api-reference/assets/overview.md
  • docs/api-reference/assets/update-user-asset.md
  • docs/api-reference/assets/update-workspace-asset.md
  • docs/api-reference/customer/add-customer-property.md
  • docs/api-reference/customer/add-customer-request.md
  • docs/api-reference/customer/add-customer.md
  • docs/api-reference/customer/delete-customer-property.md
  • docs/api-reference/customer/delete-customer-request.md
  • docs/api-reference/customer/delete-customer.md
  • docs/api-reference/customer/get-customer-detail.md
  • docs/api-reference/customer/get-customer-property-detail.md
  • docs/api-reference/customer/get-customer-property-value.md
  • docs/api-reference/customer/get-customer-request-detail.md
  • docs/api-reference/customer/link-work-items-to-customer.md
  • docs/api-reference/customer/list-customer-properties.md
  • docs/api-reference/customer/list-customer-property-values.md
  • docs/api-reference/customer/list-customer-requests.md
  • docs/api-reference/customer/list-customer-work-items.md
  • docs/api-reference/customer/list-customers.md
  • docs/api-reference/customer/unlink-work-item-from-customer.md
  • docs/api-reference/customer/update-customer-detail.md
  • docs/api-reference/customer/update-customer-property-detail.md
  • docs/api-reference/customer/update-customer-property-value.md
  • docs/api-reference/customer/update-customer-request-detail.md
  • docs/api-reference/cycle/add-cycle-work-items.md
  • docs/api-reference/cycle/add-cycle.md
  • docs/api-reference/cycle/archive-cycle.md
  • docs/api-reference/cycle/delete-cycle.md
  • docs/api-reference/cycle/get-cycle-detail.md
  • docs/api-reference/cycle/list-archived-cycles.md
  • docs/api-reference/cycle/list-cycle-work-items.md
  • docs/api-reference/cycle/list-cycles.md
  • docs/api-reference/cycle/remove-cycle-work-item.md
  • docs/api-reference/cycle/transfer-cycle-work-items.md
  • docs/api-reference/cycle/unarchive-cycle.md
  • docs/api-reference/cycle/update-cycle-detail.md
  • docs/api-reference/epics/get-epic-detail.md
  • docs/api-reference/epics/list-epics.md
  • docs/api-reference/estimate/add-estimate-points.md
  • docs/api-reference/estimate/add-estimate.md
  • docs/api-reference/estimate/delete-estimate-point.md
  • docs/api-reference/estimate/delete-estimate.md
  • docs/api-reference/estimate/get-estimate.md
  • docs/api-reference/estimate/list-estimate-points.md
  • docs/api-reference/estimate/overview.md
  • docs/api-reference/estimate/update-estimate-point.md
  • docs/api-reference/estimate/update-estimate.md
  • docs/api-reference/initiative/add-epics-to-initiative.md
  • docs/api-reference/initiative/add-initiative-label.md
  • docs/api-reference/initiative/add-initiative.md
  • docs/api-reference/initiative/add-labels-to-initiative.md
  • docs/api-reference/initiative/add-projects-to-initiative.md
  • docs/api-reference/initiative/delete-initiative-label.md
  • docs/api-reference/initiative/delete-initiative.md
  • docs/api-reference/initiative/get-initiative-detail.md
  • docs/api-reference/initiative/get-initiative-label-detail.md
  • docs/api-reference/initiative/list-initiative-epics.md
  • docs/api-reference/initiative/list-initiative-labels-for-initiative.md
  • docs/api-reference/initiative/list-initiative-labels.md
  • docs/api-reference/initiative/list-initiative-projects.md
  • docs/api-reference/initiative/list-initiatives.md
  • docs/api-reference/initiative/remove-epics-from-initiative.md
  • docs/api-reference/initiative/remove-labels-from-initiative.md
  • docs/api-reference/initiative/remove-projects-from-initiative.md
  • docs/api-reference/initiative/update-initiative-detail.md
  • docs/api-reference/initiative/update-initiative-label-detail.md
  • docs/api-reference/intake-issue/add-intake-issue.md
  • docs/api-reference/intake-issue/delete-intake-issue.md
  • docs/api-reference/intake-issue/get-intake-issue-detail.md
  • docs/api-reference/intake-issue/list-intake-issues.md
  • docs/api-reference/intake-issue/update-intake-issue-detail.md
  • docs/api-reference/issue-activity/get-issue-activity-detail.md
  • docs/api-reference/issue-activity/list-issue-activities.md
  • docs/api-reference/issue-attachments/complete-upload.md
  • docs/api-reference/issue-attachments/delete-attachment.md
  • docs/api-reference/issue-attachments/get-attachment-detail.md
  • docs/api-reference/issue-attachments/get-attachments.md
  • docs/api-reference/issue-attachments/get-upload-credentials.md
  • docs/api-reference/issue-attachments/update-attachment.md
  • docs/api-reference/issue-attachments/upload-file.md
  • docs/api-reference/issue-comment/add-issue-comment.md
  • docs/api-reference/issue-comment/delete-issue-comment.md
  • docs/api-reference/issue-comment/get-issue-comment-detail.md
  • docs/api-reference/issue-comment/list-issue-comments.md
  • docs/api-reference/issue-comment/update-issue-comment-detail.md
  • docs/api-reference/issue-types/options/add-dropdown-options.md
  • docs/api-reference/issue-types/options/delete-dropdown-options.md
  • docs/api-reference/issue-types/options/get-option-details.md
  • docs/api-reference/issue-types/options/list-dropdown-options.md
  • docs/api-reference/issue-types/options/update-dropdown-options.md
  • docs/api-reference/issue-types/properties/add-property.md
  • docs/api-reference/issue-types/properties/delete-property.md
  • docs/api-reference/issue-types/properties/get-property-details.md
  • docs/api-reference/issue-types/properties/list-properties.md
  • docs/api-reference/issue-types/properties/update-property.md
  • docs/api-reference/issue-types/types/add-issue-type.md
  • docs/api-reference/issue-types/types/delete-issue-type.md
  • docs/api-reference/issue-types/types/get-issue-type-details.md
  • docs/api-reference/issue-types/types/get-work-item-type-schema.md
  • docs/api-reference/issue-types/types/list-issue-types.md
  • docs/api-reference/issue-types/types/update-issue-types.md
  • docs/api-reference/issue-types/values/add-property-values.md
  • docs/api-reference/issue-types/values/delete-property-value.md
  • docs/api-reference/issue-types/values/get-property-value-detail.md
  • docs/api-reference/issue-types/values/list-property-values.md
  • docs/api-reference/issue-types/values/update-property-value.md
  • docs/api-reference/issue/add-issue.md
  • docs/api-reference/issue/advanced-search-work-items.md
  • docs/api-reference/issue/delete-issue.md
  • docs/api-reference/issue/get-issue-detail.md
  • docs/api-reference/issue/get-issue-sequence-id.md
  • docs/api-reference/issue/list-issues.md
  • docs/api-reference/issue/search-issues.md
  • docs/api-reference/issue/update-issue-detail.md
  • docs/api-reference/label/add-label.md
  • docs/api-reference/label/delete-label.md
  • docs/api-reference/label/get-label-detail.md
  • docs/api-reference/label/list-labels.md
  • docs/api-reference/label/update-label-detail.md
  • docs/api-reference/link/add-link.md
  • docs/api-reference/link/delete-link.md
  • docs/api-reference/link/get-link-detail.md
  • docs/api-reference/link/list-links.md
  • docs/api-reference/link/update-link-detail.md
  • docs/api-reference/members/add-project-member.md
  • docs/api-reference/members/delete-project-member.md
  • docs/api-reference/members/get-project-member-detail.md
  • docs/api-reference/members/get-project-members.md
  • docs/api-reference/members/get-workspace-members.md
  • docs/api-reference/members/remove-workspace-member.md
  • docs/api-reference/members/update-project-member.md
  • docs/api-reference/milestones/add-milestone.md
  • docs/api-reference/milestones/delete-milestone.md
  • docs/api-reference/milestones/get-milestone-detail.md
  • docs/api-reference/milestones/list-milestone-work-items.md
  • docs/api-reference/milestones/list-milestones.md
  • docs/api-reference/milestones/overview.md
  • docs/api-reference/milestones/update-milestone-detail.md
  • docs/api-reference/module/add-module-work-items.md
  • docs/api-reference/module/add-module.md
  • docs/api-reference/module/archive-module.md
  • docs/api-reference/module/delete-module.md
  • docs/api-reference/module/get-module-detail.md
  • docs/api-reference/module/list-archived-modules.md
  • docs/api-reference/module/list-module-work-items.md
  • docs/api-reference/module/list-modules.md
  • docs/api-reference/module/remove-module-work-item.md
  • docs/api-reference/module/unarchive-module.md
  • docs/api-reference/module/update-module-detail.md
  • docs/api-reference/page/add-project-page.md
  • docs/api-reference/page/add-workspace-page.md
  • docs/api-reference/page/get-project-page.md
  • docs/api-reference/page/get-workspace-page.md
  • docs/api-reference/project-features/get-project-features.md
  • docs/api-reference/project-features/overview.md
  • docs/api-reference/project-features/update-project-features.md
  • docs/api-reference/project-labels/add-project-label.md
  • docs/api-reference/project-labels/delete-project-label.md
  • docs/api-reference/project-labels/get-project-label-detail.md
  • docs/api-reference/project-labels/list-project-labels.md
  • docs/api-reference/project-labels/overview.md
  • docs/api-reference/project-labels/update-project-label-detail.md
  • docs/api-reference/project/add-project.md
  • docs/api-reference/project/archive-project.md
  • docs/api-reference/project/delete-project.md
  • docs/api-reference/project/get-project-detail.md
  • docs/api-reference/project/list-projects.md
  • docs/api-reference/project/unarchive-project.md
  • docs/api-reference/project/update-project-detail.md
  • docs/api-reference/state/add-state.md
  • docs/api-reference/state/delete-state.md
  • docs/api-reference/state/get-state-detail.md
  • docs/api-reference/state/list-states.md
  • docs/api-reference/state/update-state-detail.md
  • docs/api-reference/sticky/add-sticky.md
  • docs/api-reference/sticky/delete-sticky.md
  • docs/api-reference/sticky/get-sticky-detail.md
  • docs/api-reference/sticky/list-stickies.md
  • docs/api-reference/sticky/update-sticky-detail.md
  • docs/api-reference/teamspace/add-projects-to-teamspace.md
  • docs/api-reference/teamspace/add-teamspace-members.md
  • docs/api-reference/teamspace/add-teamspace.md
  • docs/api-reference/teamspace/delete-teamspace.md
  • docs/api-reference/teamspace/get-teamspace-detail.md
  • docs/api-reference/teamspace/list-teamspace-members.md
  • docs/api-reference/teamspace/list-teamspace-projects.md
  • docs/api-reference/teamspace/list-teamspaces.md
  • docs/api-reference/teamspace/remove-projects-from-teamspace.md
  • docs/api-reference/teamspace/remove-teamspace-members.md
  • docs/api-reference/teamspace/update-teamspace-detail.md
  • docs/api-reference/user/get-current-user.md
  • docs/api-reference/work-item-pages/add-work-item-page.md
  • docs/api-reference/work-item-pages/delete-work-item-page.md
  • docs/api-reference/work-item-pages/get-work-item-page-detail.md
  • docs/api-reference/work-item-pages/list-work-item-pages.md
  • docs/api-reference/work-item-pages/overview.md
  • docs/api-reference/worklogs/create-worklog.md
  • docs/api-reference/worklogs/delete-worklog.md
  • docs/api-reference/worklogs/get-total-time.md
  • docs/api-reference/worklogs/get-worklogs-for-issue.md
  • docs/api-reference/worklogs/update-worklog.md
  • docs/api-reference/workspace-features/get-workspace-features.md
  • docs/api-reference/workspace-features/overview.md
  • docs/api-reference/workspace-features/update-workspace-features.md
  • docs/api-reference/workspace-invitations/add-workspace-invitation.md
  • docs/api-reference/workspace-invitations/delete-workspace-invitation.md
  • docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md
  • docs/api-reference/workspace-invitations/list-workspace-invitations.md
  • docs/api-reference/workspace-invitations/overview.md
  • docs/api-reference/workspace-invitations/update-workspace-invitation.md
  • docs/dev-tools/build-plane-app/oauth-scopes.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor-update_developer_docs
📝 Coding Plan
  • Generate coding plan for human review comments

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.

Tip

CodeRabbit can use your project's `biome` configuration to improve the quality of JS/TS/CSS/JSON code reviews.

Add a configuration file to your project to customize how CodeRabbit runs biome.

@iam-vipin iam-vipin self-assigned this Mar 16, 2026
@iam-vipin iam-vipin added the documentation Improvements or additions to documentation label Mar 16, 2026
@iam-vipin iam-vipin changed the title docs: refresh API reference and add new endpoints [DOCSW-615] docs: refresh API reference and add new endpoints Mar 16, 2026
@makeplane
Copy link

makeplane bot commented Mar 16, 2026

Linked to Plane Work Item(s)

This comment was auto-generated by Plane

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants