Commit Graph

80 Commits

Author SHA1 Message Date
Sangeetha
a1d558623c [WEB-4483] fix: wi type icon in gantt view (#3755)
* fix: type_id in issue-detail endpoint

* fix: unused annotations

* fix: comments

* chore: remove prefetch_related

* chore: remove if condition
2025-07-25 17:04:18 +05:30
sriramveeraghanta
41d20f808d fix: merge conflicts 2025-07-25 17:00:48 +05:30
Bavisetti Narayan
63d025cbf4 [WEB-4544] chore: added field validations in serializer (#7460)
* chore: added field validations in serializer

* chore: added enum for roles
2025-07-25 16:50:35 +05:30
Saurabh Kumar
e14b4e0aad [SILO-396] Modify OAuth flow to move app installation out of token generate (#3694)
* refactor: oauth flow to move app installation out of create token + get installation from token

* added tests for app installation flow and webhook fix

* replace app_installation_id with id as query param
2025-07-25 16:47:49 +05:30
Dheeraj Kumar Ketireddy
f9894e095f [WEB-4560] fix: enhance OpenSearchHelper with custom filter support and fix page access in search #3743
- Added support for custom Q objects in OpenSearchHelper to allow complex filtering logic.
- Updated the EnhancedGlobalSearchEndpoint to utilize the new custom filter for page access control.
- Improved filter handling in the execute_multi_search method for better result organization.
2025-07-25 16:42:50 +05:30
Dheeraj Kumar Ketireddy
25bf6d9b60 Merge branch 'preview' into sync/ce-ee
Fixed merge conflicts

 Conflicts:
	apps/api/plane/api/serializers/__init__.py
	apps/api/plane/api/serializers/module.py
	apps/api/plane/api/urls/__init__.py
	apps/api/plane/api/urls/issue.py
	apps/api/plane/api/urls/member.py
	apps/api/plane/api/urls/module.py
	apps/api/plane/api/views/__init__.py
	apps/api/plane/api/views/asset.py
	apps/api/plane/api/views/base.py
	apps/api/plane/api/views/cycle.py
	apps/api/plane/api/views/intake.py
	apps/api/plane/api/views/issue.py
	apps/api/plane/api/views/member.py
	apps/api/plane/api/views/module.py
	apps/api/plane/api/views/project.py
	apps/api/plane/api/views/state.py
	apps/api/plane/db/models/workspace.py
	apps/api/plane/settings/common.py
	apps/api/plane/settings/openapi.py
	apps/api/plane/urls.py
	apps/api/plane/utils/openapi/__init__.py
	apps/api/plane/utils/openapi/auth.py
	apps/api/plane/utils/openapi/decorators.py
	apps/api/plane/utils/openapi/hooks.py
	apps/api/plane/utils/openapi/parameters.py
	apps/api/requirements/base.txt
2025-07-25 00:56:38 +05:30
Dheeraj Kumar Ketireddy
03a9eeb25b [WEB-4140] OpenAPI spec and external API refactor (#3750)
* Basic setup for drf-spectacular

* Updated to only handle /api/v1 endpoints

* feat: add asset and user endpoints with URL routing

- Introduced new asset-related endpoints for user assets and server assets, allowing for asset uploads and management.
- Added user endpoint to retrieve current user information.
- Updated URL routing to include new asset and user patterns.
- Enhanced issue handling with a new search endpoint for issues across multiple fields.
- Expanded member management with a new endpoint for workspace members.

* Group endpoints by tags

* Detailed schema definitions and examples for asset endpoints

* Removed unnecessary extension

* Specify avatar_url field separately

* chore: add project docs

* chore: correct all errors

* chore: added open spec in work items

* feat: enhance cycle API endpoints with detailed OpenAPI specifications

- Updated CycleAPIEndpoint and CycleIssueAPIEndpoint to include detailed OpenAPI schema definitions for GET, POST, PATCH, and DELETE operations.
- Specified allowed HTTP methods for each endpoint in the URL routing.
- Improved documentation for cycle creation, updating, and deletion, including request and response examples.

* chore: added open spec in labels

* chore: work item properties

* feat: enhance API endpoints with OpenAPI specifications and HTTP method definitions

- Added detailed OpenAPI schema definitions for various API endpoints including Intake, Module, and State.
- Specified allowed HTTP methods for each endpoint in the URL routing for better clarity and documentation.
- Improved request and response examples for better understanding of API usage.
- Introduced unarchive functionality for cycles and modules with appropriate endpoint definitions.

* chore: run formatter

* Removed unnecessary settings for authentication

* Refactors OpenAPI documentation structure

Improves the organization and maintainability of the OpenAPI documentation by modularizing the `openapi_spec_helpers.py` file.

The changes include:
- Migrates common parameters, responses, examples, and authentication extensions to separate modules.
- Introduces helper decorators for different endpoint types.
- Updates view imports to use the new module paths.
- Removes the legacy `openapi_spec_helpers.py` file.

This refactoring results in a more structured and easier-to-maintain OpenAPI documentation setup.

* Refactor OpenAPI endpoint specifications

- Removed unnecessary parameters from the OpenAPI documentation for various endpoints in the asset, cycle, and project views.
- Updated request structures to improve clarity and consistency across the API documentation.
- Enhanced response formatting for better readability and maintainability.

* Enhance API documentation with detailed endpoint descriptions

Updated various API endpoints across the application to include comprehensive docstrings that clarify their functionality. Each endpoint now features a summary and detailed description, improving the overall understanding of their purpose and usage. This change enhances the OpenAPI specifications for better developer experience and documentation clarity.

* Enhance API serializers and views with new request structures

- Added new serializers for handling cycle and module issue requests, including `CycleIssueRequestSerializer`, `TransferCycleIssueRequestSerializer`, `ModuleIssueRequestSerializer`, and intake issue creation/updating serializers.
- Updated existing serializers to improve clarity and maintainability, including the `UserAssetUploadSerializer` and `IssueAttachmentUploadSerializer`.
- Refactored API views to utilize the new serializers, enhancing the request handling for cycle and intake issue endpoints.
- Improved OpenAPI documentation by replacing inline request definitions with serializer references for better consistency and readability.

* Refactor OpenAPI documentation and endpoint specifications

- Replaced inline schema definitions with dedicated decorators for various endpoint types, enhancing clarity and maintainability.
- Updated API views to utilize new decorators for user, cycle, intake, module, and project endpoints, improving consistency in OpenAPI documentation.
- Removed unnecessary parameters and responses from endpoint specifications, streamlining the documentation for better readability.
- Enhanced the organization of OpenAPI documentation by modularizing endpoint-specific decorators and parameters.

* chore: correct formatting

* chore: correct formatting for all api folder files

* refactor: clean up serializer imports and test setup

- Removed unused `StateLiteSerializer` import from the serializer module.
- Updated test setup to include a noqa comment for the `django_db_setup` fixture, ensuring clarity in the code.
- Added missing commas in user data dictionary for consistency.

* feat: add project creation and update serializers with validation

- Introduced `ProjectCreateSerializer` and `ProjectUpdateSerializer` to handle project creation and updates, respectively.
- Implemented validation to ensure project leads and default assignees are members of the workspace.
- Updated API views to utilize the new serializers for creating and updating projects, enhancing request handling.
- Added OpenAPI documentation references for the new serializers in the project API endpoints.

* feat: update serializers to include additional read-only fields

* refactor: rename intake issue serializers and enhance structure

- Renamed `CreateIntakeIssueRequestSerializer` to `IntakeIssueCreateSerializer` and `UpdateIntakeIssueRequestSerializer` to `IntakeIssueUpdateSerializer` for clarity.
- Introduced `IssueSerializer` for nested issue data in intake requests, improving the organization of serializer logic.
- Updated API views to utilize the new serializer names, ensuring consistency across the codebase.

* refactor: rename issue serializer for intake and enhance API documentation

- Renamed `IssueSerializer` to `IssueForIntakeSerializer` for better clarity in the context of intake issues.
- Updated references in `IntakeIssueCreateSerializer` and `IntakeIssueUpdateSerializer` to use the new `IssueForIntakeSerializer`.
- Added OpenAPI documentation for the `get_workspace_work_item` endpoint, detailing parameters and responses for improved clarity.

* chore: modules and cycles serializers

* feat: add new serializers for label and issue link management

- Introduced `LabelCreateUpdateSerializer`, `IssueLinkCreateSerializer`, `IssueLinkUpdateSerializer`, and `IssueCommentCreateSerializer` to enhance the handling of label and issue link data.
- Updated existing API views to utilize the new serializers for creating and updating labels, issue links, and comments, improving request handling and validation.
- Added `IssueSearchSerializer` for searching issues, streamlining the search functionality in the API.

* Don't consider read only fields as required

* Add setting to separate request and response definitions

* Added OAuth 2 authentication for OpenAPI Spec

* Fixed avatar_url warning on openapi spec generation

* Fixed errors with openapi spec generation

* Enhance OpenAPI documentation for issue types and properties

- Updated issue type and property API endpoints to include detailed OpenAPI documentation using decorators.
- Added support for various HTTP methods (GET, POST, PATCH, DELETE) in the issue type and property views.
- Introduced new parameters and response schemas to improve API clarity and usability.
- Updated settings to categorize endpoints under "Work Item Types" and "Work Item Properties" for better organization in the OpenAPI spec.

* Made spectacular disabled by default

* Moved spectacular settings into separate file and added detailed descriptions to tags

* Specify methods for asset urls

* Better server names

* Added filter to exclude server and page endpoints from API v1 paths in OpenAPI hooks

* Refine API endpoint methods and enhance OpenAPI documentation for worklogs

- Specified HTTP methods for worklog API endpoints to support POST, GET, PATCH, and DELETE operations.
- Added detailed descriptions for "Work Item Worklogs," "Work Item Types," and "Work Item Properties" in OpenAPI settings to improve documentation clarity and usability.

* Refactor OpenAPI decorators for issue property endpoints

- Updated decorators for issue property options and values to improve documentation clarity.
- Introduced new `PROPERTY_ID_PARAMETER` for better parameter management in API paths.
- Removed redundant parameters from issue worklog API methods to streamline the documentation.

* Enhance API documentation with summaries for various endpoints

- Added summary descriptions for user asset, cycle, intake, issue, member, module, project, state, and user API endpoints to improve clarity and usability of the API documentation.
- Updated the OpenAPI specifications to reflect these changes, ensuring better understanding for developers interacting with the API.

* Add contact information to OpenAPI settings

- Included contact details for Plane in the OpenAPI settings to enhance API documentation and provide developers with a direct point of contact for support.
- This addition aims to improve the overall usability and accessibility of the API documentation.

* Enhance OpenAPI documentation across multiple endpoints

- Added summaries to various API endpoints for improved clarity and usability.
- Updated decorators for user, asset, cycle, intake, issue type, issue, module, project, state, and worklog endpoints to include descriptive summaries.
- Improved overall documentation structure to facilitate better understanding of API functionalities.

* removed repeating summary

* Reordered tags and improved description relavancy

* Refactor OpenAPI settings to enhance documentation clarity

- Reorganized and updated descriptions for various API features, including "Cycles," "Modules," "States," "Users," "Work Items," and "Work Item Properties."
- Removed redundant entries and improved the structure of feature descriptions to better reflect their functionalities and use cases.
- Added new entries for "Work Item Types" and "Work Item Worklogs" to provide comprehensive coverage of work item management capabilities.

* Enhance OpenAPI documentation for cycle and issue endpoints

- Added response definitions for the `get_cycle_issues` and `delete_cycle_issue` methods in the CycleIssueAPIEndpoint to clarify expected outcomes.
- Included additional response codes for the IssueSearchEndpoint to handle various error scenarios, improving the overall API documentation and usability.

* Enhance serializer documentation across multiple files

- Updated docstrings for various serializers including UserAssetUploadSerializer, AssetUpdateSerializer, and others to provide clearer descriptions of their functionality and usage.
- Improved consistency in formatting and language across serializer classes to enhance readability and maintainability.
- Added detailed explanations for new serializers related to project, module, and cycle management, ensuring comprehensive documentation for developers.

* chore: remove duplicate summary

* Refactor API endpoints for cycles, intake, modules, projects, and states

- Replaced existing API endpoint classes with more descriptive names such as CycleListCreateAPIEndpoint, CycleDetailAPIEndpoint, IntakeIssueListCreateAPIEndpoint, and others to enhance clarity.
- Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API.
- Improved documentation and method summaries for better understanding of endpoint functionalities.
- Enhanced query handling in the new endpoint classes to streamline data retrieval and improve performance.

* Refactor issue and label API endpoints for clarity and functionality

- Renamed existing API endpoint classes to more descriptive names such as IssueListCreateAPIEndpoint, IssueDetailAPIEndpoint, LabelListCreateAPIEndpoint, and LabelDetailAPIEndpoint to enhance clarity.
- Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API.
- Improved method summaries and documentation for better understanding of endpoint functionalities.
- Streamlined query handling in the new endpoint classes to enhance data retrieval and performance.

* Refactor asset API endpoint methods and introduce new status enums

- Updated the GenericAssetEndpoint to only allow POST requests for asset creation, removing the GET method.
- Modified the get method to require asset_id, ensuring that asset retrieval is always tied to a specific asset.
- Added new IntakeIssueStatus and ModuleStatus enums to improve clarity and management of asset and module states.
- Enhanced OpenAPI settings to include these new enums for better documentation and usability.

* enforce naming convention

* Added LICENSE to openapi spec

* Refactor issue type and property API endpoints for improved clarity and functionality

- Renamed existing API endpoint classes to more descriptive names such as IssueTypeListCreateAPIEndpoint, IssueTypeDetailAPIEndpoint, IssuePropertyListCreateAPIEndpoint, and IssuePropertyDetailAPIEndpoint.
- Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API.
- Enhanced method summaries and documentation for better understanding of endpoint functionalities.
- Streamlined query handling in the new endpoint classes to improve data retrieval and performance.

* Enhance OpenAPI documentation for various API endpoints

- Updated API endpoints in asset, cycle, intake, issue, module, project, and state views to include OpenApiRequest and OpenApiExample for better request documentation.
- Added example requests for creating and updating resources, improving clarity for API consumers.
- Ensured consistent use of OpenApi utilities across all relevant endpoints to enhance overall API documentation quality.

* Enhance OpenAPI documentation for various API endpoints

- Added detailed descriptions to multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to improve clarity for API consumers.
- Ensured consistent documentation practices by including descriptions that outline the purpose and functionality of each endpoint.
- This update aims to enhance the overall usability and understanding of the API documentation.

* Enhance OpenAPI documentation for issue types and properties by adding descriptions to various endpoints, including listing, creating, retrieving, updating, and deleting operations. Also, remove an unused import in the issue view file.

* Enhance OpenAPI documentation for issue property and value endpoints by adding request examples for creating and updating issue types, properties, options, and values. This improves clarity for API consumers on expected request formats.

* Update OpenAPI examples and enhance project queryset logic

- Changed example fields in OpenAPI documentation for issue comments from "content" to "comment_html" to reflect the correct structure.
- Introduced a new `get_queryset` method in the ProjectDetailAPIEndpoint to filter projects based on user membership and workspace, while also annotating additional project-related data such as total members, cycles, and modules.
- Updated permission checks to use the correct attribute name for project identifiers, ensuring accurate permission handling.

* Update OpenAPI documentation for issue comments to reflect changes in request format, replacing 'content' with 'comment_html'. Additionally, implement a new queryset method in ProjectDetailAPIEndpoint to enhance project filtering and member role annotations, improving data retrieval efficiency. Minor adjustments made to permission checks for project identifiers.

* Enhance OpenAPI documentation and add response examples

- Updated multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to include new OpenApiResponse examples for better clarity on expected outcomes.
- Introduced new parameters for project and issue identifiers to improve request handling and documentation consistency.
- Enhanced existing responses with detailed examples to aid API consumers in understanding the expected data structure and error handling.
- This update aims to improve the overall usability and clarity of the API documentation.

* IssueProperty Nullenum fix

* make api.plane.so default url in openapi spec

* refactor: update terminology from 'issues' to 'work items' across multiple API endpoints for consistency and clarity

* use common timezones from pytz for choices

* refactor: remove unused imports from API views

---------

Co-authored-by: pablohashescobar <nikhilschacko@gmail.com>
Co-authored-by: NarayanBavisetti <narayan3119@gmail.com>
Co-authored-by: Surya Prashanth <prashantsurya002@gmail.com>
2025-07-25 00:25:22 +05:30
Dheeraj Kumar Ketireddy
514686d9d5 [WEB-4045] feat: restructuring of the external APIs for better maintainability (#7477)
* Basic setup for drf-spectacular

* Updated to only handle /api/v1 endpoints

* feat: add asset and user endpoints with URL routing

- Introduced new asset-related endpoints for user assets and server assets, allowing for asset uploads and management.
- Added user endpoint to retrieve current user information.
- Updated URL routing to include new asset and user patterns.
- Enhanced issue handling with a new search endpoint for issues across multiple fields.
- Expanded member management with a new endpoint for workspace members.

* Group endpoints by tags

* Detailed schema definitions and examples for asset endpoints

* Removed unnecessary extension

* Specify avatar_url field separately

* chore: add project docs

* chore: correct all errors

* chore: added open spec in work items

* feat: enhance cycle API endpoints with detailed OpenAPI specifications

- Updated CycleAPIEndpoint and CycleIssueAPIEndpoint to include detailed OpenAPI schema definitions for GET, POST, PATCH, and DELETE operations.
- Specified allowed HTTP methods for each endpoint in the URL routing.
- Improved documentation for cycle creation, updating, and deletion, including request and response examples.

* chore: added open spec in labels

* chore: work item properties

* feat: enhance API endpoints with OpenAPI specifications and HTTP method definitions

- Added detailed OpenAPI schema definitions for various API endpoints including Intake, Module, and State.
- Specified allowed HTTP methods for each endpoint in the URL routing for better clarity and documentation.
- Improved request and response examples for better understanding of API usage.
- Introduced unarchive functionality for cycles and modules with appropriate endpoint definitions.

* chore: run formatter

* Removed unnecessary settings for authentication

* Refactors OpenAPI documentation structure

Improves the organization and maintainability of the OpenAPI documentation by modularizing the `openapi_spec_helpers.py` file.

The changes include:
- Migrates common parameters, responses, examples, and authentication extensions to separate modules.
- Introduces helper decorators for different endpoint types.
- Updates view imports to use the new module paths.
- Removes the legacy `openapi_spec_helpers.py` file.

This refactoring results in a more structured and easier-to-maintain OpenAPI documentation setup.

* Refactor OpenAPI endpoint specifications

- Removed unnecessary parameters from the OpenAPI documentation for various endpoints in the asset, cycle, and project views.
- Updated request structures to improve clarity and consistency across the API documentation.
- Enhanced response formatting for better readability and maintainability.

* Enhance API documentation with detailed endpoint descriptions

Updated various API endpoints across the application to include comprehensive docstrings that clarify their functionality. Each endpoint now features a summary and detailed description, improving the overall understanding of their purpose and usage. This change enhances the OpenAPI specifications for better developer experience and documentation clarity.

* Enhance API serializers and views with new request structures

- Added new serializers for handling cycle and module issue requests, including `CycleIssueRequestSerializer`, `TransferCycleIssueRequestSerializer`, `ModuleIssueRequestSerializer`, and intake issue creation/updating serializers.
- Updated existing serializers to improve clarity and maintainability, including the `UserAssetUploadSerializer` and `IssueAttachmentUploadSerializer`.
- Refactored API views to utilize the new serializers, enhancing the request handling for cycle and intake issue endpoints.
- Improved OpenAPI documentation by replacing inline request definitions with serializer references for better consistency and readability.

* Refactor OpenAPI documentation and endpoint specifications

- Replaced inline schema definitions with dedicated decorators for various endpoint types, enhancing clarity and maintainability.
- Updated API views to utilize new decorators for user, cycle, intake, module, and project endpoints, improving consistency in OpenAPI documentation.
- Removed unnecessary parameters and responses from endpoint specifications, streamlining the documentation for better readability.
- Enhanced the organization of OpenAPI documentation by modularizing endpoint-specific decorators and parameters.

* chore: correct formatting

* chore: correct formatting for all api folder files

* refactor: clean up serializer imports and test setup

- Removed unused `StateLiteSerializer` import from the serializer module.
- Updated test setup to include a noqa comment for the `django_db_setup` fixture, ensuring clarity in the code.
- Added missing commas in user data dictionary for consistency.

* feat: add project creation and update serializers with validation

- Introduced `ProjectCreateSerializer` and `ProjectUpdateSerializer` to handle project creation and updates, respectively.
- Implemented validation to ensure project leads and default assignees are members of the workspace.
- Updated API views to utilize the new serializers for creating and updating projects, enhancing request handling.
- Added OpenAPI documentation references for the new serializers in the project API endpoints.

* feat: update serializers to include additional read-only fields

* refactor: rename intake issue serializers and enhance structure

- Renamed `CreateIntakeIssueRequestSerializer` to `IntakeIssueCreateSerializer` and `UpdateIntakeIssueRequestSerializer` to `IntakeIssueUpdateSerializer` for clarity.
- Introduced `IssueSerializer` for nested issue data in intake requests, improving the organization of serializer logic.
- Updated API views to utilize the new serializer names, ensuring consistency across the codebase.

* refactor: rename issue serializer for intake and enhance API documentation

- Renamed `IssueSerializer` to `IssueForIntakeSerializer` for better clarity in the context of intake issues.
- Updated references in `IntakeIssueCreateSerializer` and `IntakeIssueUpdateSerializer` to use the new `IssueForIntakeSerializer`.
- Added OpenAPI documentation for the `get_workspace_work_item` endpoint, detailing parameters and responses for improved clarity.

* chore: modules and cycles serializers

* feat: add new serializers for label and issue link management

- Introduced `LabelCreateUpdateSerializer`, `IssueLinkCreateSerializer`, `IssueLinkUpdateSerializer`, and `IssueCommentCreateSerializer` to enhance the handling of label and issue link data.
- Updated existing API views to utilize the new serializers for creating and updating labels, issue links, and comments, improving request handling and validation.
- Added `IssueSearchSerializer` for searching issues, streamlining the search functionality in the API.

* Don't consider read only fields as required

* Add setting to separate request and response definitions

* Fixed avatar_url warning on openapi spec generation

* Made spectacular disabled by default

* Moved spectacular settings into separate file and added detailed descriptions to tags

* Specify methods for asset urls

* Better server names

* Enhance API documentation with summaries for various endpoints

- Added summary descriptions for user asset, cycle, intake, issue, member, module, project, state, and user API endpoints to improve clarity and usability of the API documentation.
- Updated the OpenAPI specifications to reflect these changes, ensuring better understanding for developers interacting with the API.

* Add contact information to OpenAPI settings

- Included contact details for Plane in the OpenAPI settings to enhance API documentation and provide developers with a direct point of contact for support.
- This addition aims to improve the overall usability and accessibility of the API documentation.

* Reordered tags and improved description relavancy

* Enhance OpenAPI documentation for cycle and issue endpoints

- Added response definitions for the `get_cycle_issues` and `delete_cycle_issue` methods in the CycleIssueAPIEndpoint to clarify expected outcomes.
- Included additional response codes for the IssueSearchEndpoint to handle various error scenarios, improving the overall API documentation and usability.

* Enhance serializer documentation across multiple files

- Updated docstrings for various serializers including UserAssetUploadSerializer, AssetUpdateSerializer, and others to provide clearer descriptions of their functionality and usage.
- Improved consistency in formatting and language across serializer classes to enhance readability and maintainability.
- Added detailed explanations for new serializers related to project, module, and cycle management, ensuring comprehensive documentation for developers.

* Refactor API endpoints for cycles, intake, modules, projects, and states

- Replaced existing API endpoint classes with more descriptive names such as CycleListCreateAPIEndpoint, CycleDetailAPIEndpoint, IntakeIssueListCreateAPIEndpoint, and others to enhance clarity.
- Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API.
- Improved documentation and method summaries for better understanding of endpoint functionalities.
- Enhanced query handling in the new endpoint classes to streamline data retrieval and improve performance.

* Refactor issue and label API endpoints for clarity and functionality

- Renamed existing API endpoint classes to more descriptive names such as IssueListCreateAPIEndpoint, IssueDetailAPIEndpoint, LabelListCreateAPIEndpoint, and LabelDetailAPIEndpoint to enhance clarity.
- Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API.
- Improved method summaries and documentation for better understanding of endpoint functionalities.
- Streamlined query handling in the new endpoint classes to enhance data retrieval and performance.

* Refactor asset API endpoint methods and introduce new status enums

- Updated the GenericAssetEndpoint to only allow POST requests for asset creation, removing the GET method.
- Modified the get method to require asset_id, ensuring that asset retrieval is always tied to a specific asset.
- Added new IntakeIssueStatus and ModuleStatus enums to improve clarity and management of asset and module states.
- Enhanced OpenAPI settings to include these new enums for better documentation and usability.

* enforce naming convention

* Added LICENSE to openapi spec

* Enhance OpenAPI documentation for various API endpoints

- Updated API endpoints in asset, cycle, intake, issue, module, project, and state views to include OpenApiRequest and OpenApiExample for better request documentation.
- Added example requests for creating and updating resources, improving clarity for API consumers.
- Ensured consistent use of OpenApi utilities across all relevant endpoints to enhance overall API documentation quality.

* Enhance OpenAPI documentation for various API endpoints

- Added detailed descriptions to multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to improve clarity for API consumers.
- Ensured consistent documentation practices by including descriptions that outline the purpose and functionality of each endpoint.
- This update aims to enhance the overall usability and understanding of the API documentation.

* Update OpenAPI examples and enhance project queryset logic

- Changed example fields in OpenAPI documentation for issue comments from "content" to "comment_html" to reflect the correct structure.
- Introduced a new `get_queryset` method in the ProjectDetailAPIEndpoint to filter projects based on user membership and workspace, while also annotating additional project-related data such as total members, cycles, and modules.
- Updated permission checks to use the correct attribute name for project identifiers, ensuring accurate permission handling.

* Enhance OpenAPI documentation and add response examples

- Updated multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to include new OpenApiResponse examples for better clarity on expected outcomes.
- Introduced new parameters for project and issue identifiers to improve request handling and documentation consistency.
- Enhanced existing responses with detailed examples to aid API consumers in understanding the expected data structure and error handling.
- This update aims to improve the overall usability and clarity of the API documentation.

* refactor: update terminology from 'issues' to 'work items' across multiple API endpoints for consistency and clarity

* use common timezones from pytz for choices

* Moved the openapi utils to the new folder structure

* Added exception logging in GenericAssetEndpoint to improve error handling

* Fixed code rabbit suggestions

* Refactored IssueDetailAPIEndpoint to streamline issue retrieval and response handling, removing redundant external ID checks and custom ordering logic.

---------

Co-authored-by: pablohashescobar <nikhilschacko@gmail.com>
Co-authored-by: NarayanBavisetti <narayan3119@gmail.com>
2025-07-25 00:17:05 +05:30
sriram veeraghanta
603950be90 Sync: Community Changes #3736 2025-07-24 14:49:49 +05:30
Sangeetha
af81064961 [WEB-4558] fix: project test cases #7464 2025-07-24 14:07:37 +05:30
Vamsi Krishna
5c3d09fd7f [WEB-4554]fix: initiative epics stats (#3730) 2025-07-23 20:20:46 +05:30
guru_sainath
dfe3c8c3db [MOBIL-1076] dev: Add advanced search support to feature flag query #3720 2025-07-23 10:21:19 +05:30
guru_sainath
ca3f4b7e59 [MOBIL-1069] dev: Add actor details to intake activity entries (#3719)
* dev: handled the actor details in intake activity details

* dev: handled the source info in intake activity
2025-07-23 10:20:48 +05:30
Sangeetha
dc0d0501a7 [WEB-4527] fix: wi description copy #3722 2025-07-23 10:19:47 +05:30
Vamsi Krishna
759a0978fd [WEB-4251]feat: scope page for initiatives (#3676) 2025-07-22 17:44:40 +05:30
Bavisetti Narayan
68eadba1d5 [WEB-4545] fix: filters in the global views #3714 2025-07-22 16:35:30 +05:30
Surya Prashanth
d4fd8353d3 [SILO-401] fix: log exceptions in data_import_task (#3716) 2025-07-22 16:35:04 +05:30
Dheeraj Kumar Ketireddy
c1b1cd033d [WEB-4543] fix: update issue ID extraction in TransferCycleIssueAPIEndpoint #3712 2025-07-22 13:00:06 +05:30
Sangeetha
a743a3c8c3 [WEB-4527] fix: duplicating description attachments (#3705) 2025-07-21 19:49:11 +05:30
guru_sainath
b912eac31a [MOBIL-913] feat: Implement mobile intakes with CRUD, activity, comments, reactions, and attachments (#3527) 2025-07-21 13:54:45 +05:30
Prateek Shourya
69aaa6f0ce [WEB-4389] feat: add (sub) work items in Work item Templates and Project Templates (#3530) 2025-07-21 13:34:05 +05:30
Sangeetha
210774f855 [WEB-4493] fix: global views sub work items toggle (#3698)
* fix: filtering logic for workspace view

* fix: show sub-wi toggle hides epic's sub wi
2025-07-18 20:29:59 +05:30
NarayanBavisetti
e00f756673 chore: resolved merge conflicts 2025-07-18 20:18:21 +05:30
Vamsi Krishna
d7d1545801 [WEB-4192]fix: inactive member is hidden in created by #7435 2025-07-18 20:08:59 +05:30
Bavisetti Narayan
a75ae71ff0 [WEB-4442] fix: removed the deleted labels from webhook payload (#7337)
* chore: removed the deleted label from payload

* chore: optimised the query

* chore: optimised the logic

* chore: defined function for prefetch
2025-07-18 20:08:01 +05:30
Anmol Singh Bhatia
bfe77c3f16 [WEB-4525] fix: project create/update error handling (#3695)
* fix: internal server error

* refactor: project creation endpoint

* chore: project create/update error handling

---------

Co-authored-by: sangeethailango <sangeethailango21@gmail.com>
2025-07-17 19:11:56 +05:30
Saurabh Kumar
dfb1e2e639 [SILO-341] Application Uninstall Flow (#3529)
* add app uninstall endpoint and tests

* Implement app uninstall webhook and update uninstall endpoint to trigger webhook on application uninstallation

* fix test cases

* modifications to fix tests failure

* moved app uninstall webhook call to view
2025-07-17 13:46:31 +05:30
sriram veeraghanta
e691ec75e8 fix: local environment setup using docker local (#3680)
* fix: local environment setup

* fix(dev): get silo migration working

* fix(dev): fix env var expansion

* fix(dev): permit live server to import logger

* fix(dev): silo connection to mq

* fix(dev): few more build errors resolved

---------

Co-authored-by: Aaron Heckmann <aaron@plane.so>
2025-07-17 13:34:06 +05:30
pablohashescobar
c10cfcb30b Remove unused import 2025-07-17 13:30:23 +05:30
pablohashescobar
ac0de582f6 Merge branch 'sync/ce-ee' of github.com:makeplane/plane-ee into sync/ce-ee 2025-07-17 13:30:18 +05:30
pablohashescobar
2b9345dcc1 Merge branch 'preview' of github.com:makeplane/plane-ee into sync/ce-ee 2025-07-17 13:20:30 +05:30
Sangeetha
e313aee3df [WEB-4346] chore: refactor copy_s3_object bg task (#7298) 2025-07-17 13:10:34 +05:30
Sangeetha
ec0ef98c1b [WEB-4281] chore: error code on project updation endpoint (#7218) 2025-07-17 13:05:24 +05:30
Bavisetti Narayan
ef0e3dca12 [WEB-4520] chore: changed the serializer for cycle issues #7423 2025-07-17 12:53:04 +05:30
Aaryan Khandelwal
a0a60baa8e fix: merge conflicts resolved from preview 2025-07-16 01:37:24 +05:30
Bavisetti Narayan
3224122df0 [WEB-1643] chore: support cyrillic characters in subject #7336 2025-07-16 01:04:59 +05:30
Sangeetha
99127ff8e4 [WEB-4479] feat: enable/disable SMTP configuration (#7393)
* feat: api update instance configuration

* chore: add enable_smtp key

* fix: empty string for enable_smtp key

* chore: update email_port and email_from

* fix: handled smtp enable disable

* fix: error handling

* fix: refactor

* fix: removed enabled toast

* fix: refactor

---------

Co-authored-by: gakshita <akshitagoyal1516@gmail.com>
Co-authored-by: Akshita Goyal <36129505+gakshita@users.noreply.github.com>
2025-07-16 01:04:18 +05:30
Saurabh Kumar
5eaf2c1c17 [SILO-354] Make modification for workspace switcher to handle external apps (#3580)
* add get published app by slug endpoint + support for external app feature in workspace selector

* moved service init outside methods

* moved service init outside the render method

* redirect to applications page if app is installed + default to third_party apps

* fix: bot not getting added to projects on interupted flow
2025-07-15 18:17:35 +05:30
Saurabh Kumar
1ee76614c3 [SILO-355] Add configuration url and is_internal to Applications (#3583)
* feat: add configuration_url field to Application model and update related components

* remove configuration_url in migrations

* add sub commands to make app internal and external
2025-07-15 18:17:25 +05:30
Saurabh Kumar
cdb2e82e9c [SILO-389] Clickup additional logs and bug fix for phase 2 not starting (#3671)
* fix status mapping in phase 1 + handle race condn + addn logs

* enhancement: increase wait time for requeuing pages and handle empty paginated batches in BaseDataMigrator
2025-07-15 18:17:10 +05:30
pushya22
933ede4c34 Sync: Community Changes #3669 2025-07-15 13:26:03 +05:30
Nikhil
ac928f263a [WIKI-520] fix: update content disposition handling in asset download endpoints (#7380) 2025-07-15 13:24:17 +05:30
Dheeraj Kumar Ketireddy
f6d9838d5a Import documents module only if opensearch is enabled (#3667) 2025-07-14 21:30:54 +05:30
sriram veeraghanta
ab9876473b Sync: Community Changes #3665 2025-07-14 21:12:27 +05:30
Prateek Shourya
17af39babc fix: reorganize OpenSearch settings under OPENSEARCH_ENABLED condition for better clarity and maintainability (#3664) 2025-07-14 21:12:03 +05:30
Bavisetti Narayan
62065a6ebb [WEB-4504] chore: added migration for app rail and reactions #7408 2025-07-14 20:57:29 +05:30
Prateek Shourya
67b62dcbe3 [WEB-4498] improvement: remove workspace details from workspace members list API (#7407)
* [WEB-4498] improvement: remove workspace details from workspace members list API

* refactor: update select_related usage in workspace invitation and member views

---------

Co-authored-by: Dheeraj Kumar Ketireddy <dheeru0198@gmail.com>
2025-07-14 20:45:23 +05:30
Henit Chobisa
919001dfce [SILO-286] feat: added migration for sentry integration (#3606)
* feat: added migration for sentry integration

* Apply suggestion from @Prashant-Surya

* fix: redirect uri

---------

Co-authored-by: Surya Prashanth <prashantsurya002@gmail.com>
2025-07-14 17:23:32 +05:30
Sangeetha
731a37243e [WEB-4346] fix: links and attachments not duplicating (#3455)
* fix: links and attachments are not duplicating

* fix: attachment not downloaded

* chore: use deepcopy

* fix: attachment not copying in s3

* chore: tests for IssueDuplicateEndpoint

* chore: resolve copilot reviews

* chore: separate function for attachment asset duplication

* chore: separate function for attachment asset duplication

* WIP

* fix: issue description copy

* fix: unused imports

* chore: tests for issue attachment bg task

* fix: function name

* chore: add comments and type hints.
2025-07-14 17:18:54 +05:30
sriramveeraghanta
ca90b62774 fix: merge conflicts 2025-07-14 17:15:52 +05:30