- Call_Guide
- Common
- Common Foundation Tutorial
- System Health & Access
- Access and Authorization
- Security
- Organization & Project
- Organization and Project Tutorial
- Project Management
- Organization Management
- Members & Permissions Management
- Device Management
- Device Management Tutorial
- Device Configuration
- Device List Management
- Project Device List
- Organization Device List
- Query Organization Device Simplified List
- Batch Modify Organization Device Call Sign
- Modify Single Organization Device Call Sign
- Batch Remove Organization Devices
- Query Organization Device O&M List
- Query Model Primary Key List for a Device Category in Organization
- Query Organization Device Online Working Quota
- Real-time Control
- Real-Time Control Tutorial
- Flight Control Commands
- Control Permission Management
- Payload Control
- Takeoff-Landing Coordination
- Flight Task
- Flight Tasks Tutorial
- Task Query
- Flight Record
- Task Management
- Create Flight Task
- Create Flight Task (Advanced Version, Returns Subtasks)
- Check Whether Flight Task Meets Dispatch Conditions
- Mark Task as Read
- Check Flight Task Block Items
- Resumable Immediate Task
- Delete Flight Task
- Edit Flight Task
- Get Flight Task Details
- Dispatch Task Media Priority Upload Command
- Create Resume Flight Task (Retain Original Breakpoint)
- Update Flight Task Suspend Status (Suspend / Resume / Cancel)
- Query Flight Task List
- AI Flight Alert
- Wayline
- Waylines Tutorial
- Download and Upload
- Wayline List Management
- Get Wayline KMZ Download URL and 302 Redirect
- Copy Wayline
- Favorite Wayline / Media Resource
- Unfavorite Wayline / Media Resource
- Stitch Multiple Waylines into One
- Wayline Library File List Query (V1)
- Delete Specified Wayline (default soft delete to recycle bin)
- Update Wayline Metadata (Rename / Lock / Restore from Recycle Bin)
- Get Single Wayline Details
- Wayline File CRUD
- Map
- Map Tutorial
- Map Annotation
- Annotation Layer Management
- Move / Reorder Layers and Features
- Delete Single Annotation Layer (Folder)
- Update Annotation Layer (Rename / Reorder)
- Distribute Annotation Layer to Device
- Lock / Unlock Annotation Layer
- Cancel Annotation Layer Distribution
- Batch Delete Annotation Layers / Features
- Create Annotation Layer (Folder)
- Query Annotation Layer (Folder) List
- Annotation Feature Management
- Batch Modify Display Status of Features Under Layer
- Clear All Annotation Features Under Specified Layer
- Create Annotation Feature Under Specified Layer
- Batch Import Layers and Annotations (KML-Style JSON)
- Export Features Under Layer Group (KML-Style JSON)
- Delete Single Annotation Feature
- Update Annotation Feature (Rename / Modify Coordinates / Modify Style / Reorder)
- Custom Icon
- Annotation Layer Management
- Signal Heatmap
- Airspace Safety
- Offline Map
- Livestream
- Live Streaming Tutorial
- Livestream Sharing & Forwarding
- Livestream Push
- Project Level
- Start Livestream (Project Level)
- Update Viewer Tokens (Project Level)
- Switch Camera (Project Level)
- Switch Livestream Camera (Project Level)
- Report Viewer Join Livestream Room Status (Project Level)
- Stop Livestream (Project Level)
- Set Livestream Quality (Project Level, aircraft source-side push level)
- Query Device Livestream and Recording Status (Project Level)
- Organization Level
- Stop Livestream (Organization Level)
- Set Livestream Quality (Organization Level, aircraft source-side push level)
- Report Viewer Join Livestream Room Status (Organization Level)
- Start Livestream (Organization Level)
- Switch Camera (Organization Level, also controls aircraft source-side hardware)
- Update Viewer Tokens (Organization Level)
- Switch Livestream Camera (Organization Level)
- Project Level
- Recording Task Management
- Start Cloud Recording (Project Level)
- Stop Cloud Recording (Project Level)
- Query Device Recording Task List (Project Level)
- Start Intra-Project Livestream
- Query Device Recording Task List (Organization Level)
- Start Cloud Recording (Organization Level)
- Stop Cloud Recording (Organization Level)
- Stop Intra-Project Livestream Recording
- Media
- Model
- Models Tutorial
- Model Reconstruction
- Geographic Systems
- Get Flight Task Folder List V2
- Get Real-time Mapping Task List
- Initiate Real-time Mapping Task (Realtime2D)
- Get Project Model Library Default Settings
- Initiate Post-Processing Reconstruction Task (Post 2D / 3D)
- Get Post-Reconstruction Default ROI
- Get Post-Reconstruction Quality Report Download Link
- Post-Reconstruction Task Retry
- Stop Post-Reconstruction Task
- Model Upload Completion Callback (called by client, not OSS signature verification)
- Query Wayline List Available for Model Reconstruction
- Model Library
- Model File Management
- Batch Delete Model Files
- Get Project Model File List
- Create Model Folder
- Batch Toggle Model Map Display Status
- Lock / Unlock Model File
- Batch Move Model Files
- Intra-Org Model Sharing
- Get Total Model File Count
- Delete Single Model File
- Get Model File Details
- Update Model Basic Info
- Get Model File Download URL
- Initiate Model Format / Coordinate System Conversion Task
- Get Available Coordinate System (WKT) List for Project
- Map Display
- Batch Set Terrain Loading Status of Real-time Mapping Models
- Adjust Display Order of Real-time Mapping Models (Drag-and-Drop Sort)
- Update Mapping Task Metadata (Rename / Show-Hide / Distribute / Undistribute / Toggle Terrain)
- Get Map Page Model Layer List
- Batch Toggle Map Model Layer Attributes
- Adjust Map Model Layer Stacking Order
- Model File Management
- Recycle Bin
- Recycle Bin Tutorial
- Hard Delete Single Media File
- Restore File from Recycle Bin
- Permanently Delete Recycle Bin Files
- Get Media Recycle Bin File List
- Modify Media Recycle Bin Configuration
- Get Media Recycle Bin Configuration
- Get Model Library Recycle Bin Disk Statistics
- Get Media Recycle Bin Disk Statistics
- Advanced Capabilities
- Advanced Capabilities Tutorial
- Change Detection
- Media Change Detection
- Initiate Media Spot-the-Difference Task
- Query Media Spot-the-Difference Task List
- Delete Spot-the-Difference Task
- Modify Spot-the-Difference Task Name and Other Attributes
- Get Spot-the-Difference Task Details
- Evaluate Spot-the-Difference Task
- Batch Modify Spot-the-Difference Result Status
- Delete Change Area
- Add Change Area (Manual Annotation)
- Update Change Area Attributes
- Get Media Upload STS Credentials
- Media Spot-the-Difference Task Pre-check
- View Spot-the-Difference Detection Report
- Get Photo Group AI Spot-the-Difference Result List
- Get Change Area Details in Result Group
- Model Change Detection
- Initiate Model Comparison Task (Spot-the-Difference)
- Query Model Comparison Task List
- Modify Model Comparison Task Name and Other Attributes
- Get Model Comparison Task Result Details
- Delete Model Comparison Task
- Batch Update Model Comparison Diff
- Delete Model Comparison Diff
- Add Model Comparison Diff (Manual Annotation)
- Update Single Model Comparison Diff Details
- Get Model Comparison Detection Report
- Query Candidate Models Suitable for Model Comparison
- Evaluate Model Comparison Task
- Media Change Detection
- Open Modeling
- Schemas
- Default Directory
- StsCredentials
- PutWorkspacesWaylinesBatchDeleteResp
- PutWorkspacesWaylinesLockStatusResp
- C0160_GetFlightTaskAdvanced_Resp
- C0617_GetFlightTasks_Resp
- StsResult
- C0619_CreateBatchDownload_Resp
- GetWorkspacesFilesCompareFilesResp
- ProjectTeamGetDevicesRsp
- PostWorkspacesStsResp
- Resp
- ApiEnvelope
- ServiceError
- PagyInfo
- GetDiffMediaTaskIdGetReportResp
- GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsResp
- GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsByResultUuidResp
- PostWorkspacesComparatorsResultGroupsDiffDetailResp
- DeleteWorkspacesComparatorsResultGroupsDiffDetailResp
- GetDiffModelTaskIdGetResultResp
- PostWorkspacesComparatorsDiffDetailResp
- DeleteWorkspacesComparatorsDiffDetailResp
- GetDiffModelTaskIdGetReportResp
- GetWorkspacesComparatorsMatchImageResp
- ApiPagedEnvelope
- InitPermissionTreeNode
- PutWorkspacesWaylineMoveResp
- DeleteWorkspacesWaylinesByIdResp
- PostWorkspacesWaylinesConcatResp
- C0148_ExportRecords_Resp
- C0362_GetWaylineImportState_Resp
- ProjectTeamGetDevicesRspItem
- ProjectTeamGetDevicesRspItemBaseTopo
- DeviceModelEnum
- Position
- DeviceState_ea210dock
- DeviceState_ea220dock
- DeviceState_ea230dock
- DeviceState_ea210drone
- DeviceState_ea220drone
- DeviceState_ea230drone
- DeviceState_wm265
- DeviceState_wa345
- DeviceState_drone_other
- DeviceState_rc_other
- DeviceState_rc510
- DeviceState_rc701
- Default Directory
Modify Organization Device's Current Workspace Project
PUT
/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/active-project
1.
2.
3.
4.
5.
"" for active_project_uuid means unbind from current project (semantically different from "field not passed"). Quota Exceeded Response: code non-zero, and data.device_online_limit.limit_online_num returns organization limit; frontend pops up prompt accordingly. Call Conditions: caller must be organization administrator/super administrator.Request
Path Params
Header Params
Body Params application/jsonRequired
Example
{
"device_sn": "2TUDK87654321",
"active_project_uuid": "660e8400-e29b-41d4-a716-446655440111"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/openapi/v2.0/manage/api/v1/organizations//manage-devices/active-project' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
"device_sn": "2TUDK87654321",
"active_project_uuid": "660e8400-e29b-41d4-a716-446655440111"
}'Responses
🟢200
application/json
Bodyapplication/json
Example
{
"code": 0,
"message": "OK",
"data": null
}🟠400
🔴500
Modified at 2026-06-15 13:36:31