- FlightHub 2 OpenAPI V2.0
- Usage Guide
- Common
- Organization & Project
- Organization & Project Tutorial
- Members & Permissions Management
- Project Members
- Organization Members
- Roles & Permissions
- Project Management
- Organization Management
- Device Management
- Real-time Control
- Livestream
- Flight Task
- Wayline
- Map
- Model Reconstruction
- Open Modeling
Get Role Permissions
GET
/openapi/v2.0/organizations/{uuid}/roles/permissions
Request
Path Params
Query Params
Header Params
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 '/openapi/v2.0/organizations/105ddd05-34ce-46b6-a872-cb32b8c98f64/roles/permissions?role_id=role-uuid-001&type=project' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh'Responses
🟢200
application/json
Bodyapplication/json
Example
{
"code": 0,
"message": "OK",
"data": {
"init_permissions": [
{
"permission_id": "project-overview-and-management",
"permission_name": "Project Management",
"permission_description": "",
"children": [
{
"permission_id": "manage-project",
"permission_name": "Project Settings Management",
"permission_description": "",
"predecessor": [
"team-view-device"
],
"created_at": "2026-05-11T12:16:44.607Z",
"frontend_resources": [
"project-edit-front"
],
"sequence": 2
}
],
"created_at": "2026-05-11T12:16:44.605Z",
"frontend_resources": null,
"sequence": 1
},
{
"permission_id": "device-management",
"permission_name": "Device Management",
"permission_description": "",
"children": [
{
"permission_id": "team-view-device",
"permission_name": "Team Device Viewing",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.612Z",
"frontend_resources": [
"get-topo-front-ws"
],
"sequence": 4
},
{
"permission_id": "device-operation",
"permission_name": "Device Operations",
"permission_description": "",
"children": [
{
"permission_id": "remote-debug",
"permission_name": "Dock operation parameter modification and remote debugging",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.616Z",
"frontend_resources": [
"remote-debug-switch"
],
"sequence": 6
}
],
"created_at": "2026-05-11T12:16:44.614Z",
"frontend_resources": null,
"sequence": 5
}
],
"created_at": "2026-05-11T12:16:44.61Z",
"frontend_resources": null,
"sequence": 3
},
{
"permission_id": "flight-and-live",
"permission_name": "Flight & Livestream",
"permission_description": "",
"children": [
{
"permission_id": "device-control",
"permission_name": "Device Control",
"permission_description": "",
"children": [
{
"permission_id": "base-device-control",
"permission_name": "Device Control Basic Permission",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.623Z",
"frontend_resources": null,
"sequence": 9
},
{
"permission_id": "enter-virtual-cockpit",
"permission_name": "Enter Virtual Cockpit",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.626Z",
"frontend_resources": [
"virtual-cockpit-page"
],
"sequence": 10
},
{
"permission_id": "remote-aircraft-real-time-control",
"permission_name": "Remote Aircraft Real-time Control",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.628Z",
"frontend_resources": [
"recommend-fly-to-here"
],
"sequence": 11
},
{
"permission_id": "remote-payload-real-time-control",
"permission_name": "Remote Payload Real-time Control",
"permission_description": "",
"children": [
{
"permission_id": "remote-speaker-control",
"permission_name": "Remote Speaker Control",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.822Z",
"frontend_resources": null,
"sequence": 0
}
],
"created_at": "2026-05-11T12:16:44.631Z",
"frontend_resources": null,
"sequence": 12
}
],
"created_at": "2026-05-11T12:16:44.621Z",
"frontend_resources": null,
"sequence": 8
},
{
"permission_id": "live-stream-management",
"permission_name": "Livestream Management",
"permission_description": "",
"children": [
{
"permission_id": "initiate-live-stream",
"permission_name": "Start Livestream",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.635Z",
"frontend_resources": null,
"sequence": 14
},
{
"permission_id": "open-live-screen",
"permission_name": "Open Multi-Stream Livestream",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.638Z",
"frontend_resources": [
"live-screen-page"
],
"sequence": 15
},
{
"permission_id": "initiate-live-sharing",
"permission_name": "Livestream Sharing",
"permission_description": "",
"children": [
{
"permission_id": "view-live-sharing",
"permission_name": "View Livestream Share Records",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.643Z",
"frontend_resources": null,
"sequence": 16
},
{
"permission_id": "edit-live-sharing",
"permission_name": "Start/Modify Livestream Share",
"permission_description": "",
"predecessor": [
"view-live-sharing"
],
"created_at": "2026-05-11T12:16:44.645Z",
"frontend_resources": null,
"sequence": 16
},
{
"permission_id": "delete-live-sharing",
"permission_name": "Delete Livestream Share Record",
"permission_description": "",
"predecessor": [
"view-live-sharing"
],
"created_at": "2026-05-11T12:16:44.647Z",
"frontend_resources": null,
"sequence": 16
}
],
"created_at": "2026-05-11T12:16:44.64Z",
"frontend_resources": null,
"sequence": 16
},
{
"permission_id": "start-live-recording",
"permission_name": "Enable Livestream Recording",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.65Z",
"frontend_resources": null,
"sequence": 17
}
],
"created_at": "2026-05-11T12:16:44.633Z",
"frontend_resources": null,
"sequence": 13
},
{
"permission_id": "no-fly-zone-management",
"permission_name": "Map Operation Area Management",
"permission_description": "",
"children": [
{
"permission_id": "device-sync-view",
"permission_name": "Device Sync View",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.654Z",
"frontend_resources": null,
"sequence": 19
},
{
"permission_id": "custom-no-fly-zone-management",
"permission_name": "Custom Flight Area Management",
"permission_description": "",
"children": [
{
"permission_id": "custom-no-fly-zone-view",
"permission_name": "View Custom Flight Areas",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.659Z",
"frontend_resources": [
"get-custom-flight-area-front"
],
"sequence": 21
},
{
"permission_id": "no-fly-zone-create",
"permission_name": "Add Flight Area",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.661Z",
"frontend_resources": [
"flight-areas-front"
],
"sequence": 22
},
{
"permission_id": "no-fly-zone-delete",
"permission_name": "Delete Flight Area",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.664Z",
"frontend_resources": null,
"sequence": 23
},
{
"permission_id": "no-fly-zone-enable-disable",
"permission_name": "Enable/Disable Flight Area",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.667Z",
"frontend_resources": null,
"sequence": 24
}
],
"created_at": "2026-05-11T12:16:44.657Z",
"frontend_resources": null,
"sequence": 20
},
{
"permission_id": "terrain-obstacle-management",
"permission_name": "Terrain Obstacle Management",
"permission_description": "",
"children": [
{
"permission_id": "terrain-obstacle-view",
"permission_name": "View Terrain Obstacles",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.672Z",
"frontend_resources": [
"get-terrain-obstacle-front"
],
"sequence": 26
},
{
"permission_id": "terrain-obstacle-toggle-update",
"permission_name": "Terrain Obstacle Toggle & Update",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.674Z",
"frontend_resources": null,
"sequence": 27
}
],
"created_at": "2026-05-11T12:16:44.669Z",
"frontend_resources": null,
"sequence": 25
}
],
"created_at": "2026-05-11T12:16:44.652Z",
"frontend_resources": null,
"sequence": 18
}
],
"predecessor": [
"team-view-device",
"view-plan"
],
"created_at": "2026-05-11T12:16:44.619Z",
"frontend_resources": null,
"sequence": 7
},
{
"permission_id": "wayline-management",
"permission_name": "Wayline Management",
"permission_description": "",
"children": [
{
"permission_id": "wayline-view",
"permission_name": "View Waylines",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.679Z",
"frontend_resources": [
"get-wayline-front",
"wayline-view-front"
],
"sequence": 29
},
{
"permission_id": "wayline-edit",
"permission_name": "Edit Waylines",
"permission_description": "",
"children": [
{
"permission_id": "wayline-create",
"permission_name": "Create/Edit Wayline",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.684Z",
"frontend_resources": [
"wayline-create-front",
"wayline-import-front"
],
"sequence": 31
},
{
"permission_id": "wayline-lock-unlock",
"permission_name": "Lock/Unlock Wayline",
"permission_description": "",
"predecessor": [
"wayline-create"
],
"created_at": "2026-05-11T12:16:44.686Z",
"frontend_resources": [
"wayline-lock-unlock-front"
],
"sequence": 33
},
{
"permission_id": "wayline-concat",
"permission_name": "Stitched Wayline",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.689Z",
"frontend_resources": [
"wayline-concat-front"
],
"sequence": 34
},
{
"permission_id": "wayline-download",
"permission_name": "Wayline Download",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.691Z",
"frontend_resources": [
"wayline-batch-download-front"
],
"sequence": 35
},
{
"permission_id": "wayline-delete",
"permission_name": "Delete Wayline",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.693Z",
"frontend_resources": [
"wayline-delete-front"
],
"sequence": 36
},
{
"permission_id": "project-ai-inside-models-view",
"permission_name": "View Wayline Third-Party Algorithms",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.819Z",
"frontend_resources": [
"project-ai-inside-models-view-front"
],
"sequence": 76
}
],
"created_at": "2026-05-11T12:16:44.682Z",
"frontend_resources": null,
"sequence": 30
}
],
"created_at": "2026-05-11T12:16:44.677Z",
"frontend_resources": null,
"sequence": 28
},
{
"permission_id": "plan-management",
"permission_name": "Plan Management",
"permission_description": "",
"children": [
{
"permission_id": "view-plan",
"permission_name": "View Plans",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.698Z",
"frontend_resources": null,
"sequence": 38
},
{
"permission_id": "operate-task",
"permission_name": "Operation Plan",
"permission_description": "",
"children": [
{
"permission_id": "create-and-edit-task",
"permission_name": "Create and Edit Plan",
"permission_description": "",
"predecessor": [
"wayline-delete",
"wayline-create"
],
"created_at": "2026-05-11T12:16:44.702Z",
"frontend_resources": [
"copy-plan-front",
"create-task-front",
"edit-plan-front"
],
"sequence": 40
},
{
"permission_id": "view-flight-record",
"permission_name": "View Flight Records",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.705Z",
"frontend_resources": null,
"sequence": 41
},
{
"permission_id": "delete-plan",
"permission_name": "Delete Plan",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.707Z",
"frontend_resources": null,
"sequence": 42
},
{
"permission_id": "media-upload",
"permission_name": "Immediate Media Upload",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.709Z",
"frontend_resources": null,
"sequence": 43
},
{
"permission_id": "task-suspend",
"permission_name": "Task Suspend/Unsuspend",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.712Z",
"frontend_resources": null,
"sequence": 44
},
{
"permission_id": "flight-record-export-v2",
"permission_name": "Export Flight Records",
"permission_description": "Export Flight Records",
"created_at": "2026-05-11T12:16:44.801Z",
"frontend_resources": null,
"sequence": 45
}
],
"created_at": "2026-05-11T12:16:44.7Z",
"frontend_resources": null,
"sequence": 39
}
],
"predecessor": [
"team-view-device",
"wayline-view"
],
"created_at": "2026-05-11T12:16:44.696Z",
"frontend_resources": null,
"sequence": 37
},
{
"permission_id": "data-view-and-management",
"permission_name": "Data Management",
"permission_description": "",
"children": [
{
"permission_id": "model-management",
"permission_name": "Model Management",
"permission_description": "",
"children": [
{
"permission_id": "model-view",
"permission_name": "View Models",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.719Z",
"frontend_resources": [
"get-imagery-front",
"get-model-front",
"model-comparator-front",
"model-view-front"
],
"sequence": 47
},
{
"permission_id": "realtime-reconstruction",
"permission_name": "Real-time Reconstruction",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.721Z",
"frontend_resources": null,
"sequence": 48
},
{
"permission_id": "post-reconstruction",
"permission_name": "Model Reconstruction",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.723Z",
"frontend_resources": [
"post-reconstruction-front"
],
"sequence": 51
},
{
"permission_id": "model-files-management",
"permission_name": "Model File Management",
"permission_description": "",
"children": [
{
"permission_id": "model-file-and-folder-renaming-moving-deletion",
"permission_name": "Model files and folders rename/move/delete",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.749Z",
"frontend_resources": null,
"sequence": 53
},
{
"permission_id": "model-download",
"permission_name": "Model Download",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.752Z",
"frontend_resources": null,
"sequence": 54
},
{
"permission_id": "model-import",
"permission_name": "Import Model",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.754Z",
"frontend_resources": [
"model-import-front"
],
"sequence": 55
},
{
"permission_id": "model-lock-unlock",
"permission_name": "Lock/Unlock Model",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.757Z",
"frontend_resources": null,
"sequence": 56
},
{
"permission_id": "model-show-on-map",
"permission_name": "Load on Map",
"permission_description": "",
"predecessor": [
"map-models-management"
],
"created_at": "2026-05-11T12:16:44.759Z",
"frontend_resources": [
"model-show-on-map-front"
],
"sequence": 57
},
{
"permission_id": "model-share",
"permission_name": "Share Model to Other Projects",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.761Z",
"frontend_resources": null,
"sequence": 58
},
{
"permission_id": "model-share-backend",
"permission_name": "Share Model",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.798Z",
"frontend_resources": [
"model-share-front"
],
"sequence": 73
}
],
"created_at": "2026-05-11T12:16:44.726Z",
"frontend_resources": null,
"sequence": 52
},
{
"permission_id": "model-comparators-management",
"permission_name": "Change Detection Management",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.764Z",
"frontend_resources": [
"model-ai-diff-front"
],
"sequence": 59
},
{
"permission_id": "map-models-management",
"permission_name": "Map Model Management",
"permission_description": "Map Model Management",
"predecessor": [
"model-show-on-map"
],
"created_at": "2026-05-11T12:16:44.766Z",
"frontend_resources": null,
"sequence": 60
},
{
"permission_id": "map-models-management",
"permission_name": "Map Model Management",
"permission_description": "Map Model Management",
"predecessor": [
"model-show-on-map"
],
"created_at": "2026-05-11T12:16:44.766Z",
"frontend_resources": null,
"sequence": 60
}
],
"created_at": "2026-05-11T12:16:44.716Z",
"frontend_resources": null,
"sequence": 46
},
{
"permission_id": "map-mark-management",
"permission_name": "Map Annotation Management",
"permission_description": "",
"children": [
{
"permission_id": "map-mark-view",
"permission_name": "View Annotations",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.771Z",
"frontend_resources": [
"get-layer-front",
"map-mark-view-front"
],
"sequence": 62
},
{
"permission_id": "map-mark-edit",
"permission_name": "Edit Annotations",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.774Z",
"frontend_resources": [
"map-mark-edit-front"
],
"sequence": 62
},
{
"permission_id": "map-mark-lock-unlock",
"permission_name": "Map Annotation Lock/Unlock",
"permission_description": "Map Annotation Lock/Unlock",
"created_at": "2026-05-11T12:16:44.777Z",
"frontend_resources": null,
"sequence": 64
},
{
"permission_id": "map-element-distribute-undistribute",
"permission_name": "Map Annotation Distribute/Undistribute",
"permission_description": "Map Annotation Distribute/Undistribute",
"created_at": "2026-05-11T12:16:44.779Z",
"frontend_resources": null,
"sequence": 65
}
],
"created_at": "2026-05-11T12:16:44.769Z",
"frontend_resources": null,
"sequence": 61
},
{
"permission_id": "media-management",
"permission_name": "Media Management",
"permission_description": "",
"children": [
{
"permission_id": "media-view",
"permission_name": "View Media Library Files",
"permission_description": "",
"is_basic_permission": true,
"created_at": "2026-05-11T12:16:44.784Z",
"frontend_resources": [
"get-map-media-front"
],
"sequence": 67
},
{
"permission_id": "media-file-and-folder-renaming-moving-deletion",
"permission_name": "Media files and folders rename/move/delete",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.786Z",
"frontend_resources": [
"media-delete-front",
"media-move-front"
],
"sequence": 68
},
{
"permission_id": "media-download",
"permission_name": "Download Media",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.788Z",
"frontend_resources": [
"media-zip-download-front"
],
"sequence": 69
},
{
"permission_id": "media-comparators-management",
"permission_name": "Change Detection Management",
"permission_description": "",
"predecessor": [
"wayline-view"
],
"created_at": "2026-05-11T12:16:44.791Z",
"frontend_resources": [
"media-ai-diff-front"
],
"sequence": 70
},
{
"permission_id": "media-share",
"permission_name": "Share Media",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.793Z",
"frontend_resources": [
"media-share-front"
],
"sequence": 71
},
{
"permission_id": "media-ai-search",
"permission_name": "Smart Search Management",
"permission_description": "",
"predecessor": [
"media-view"
],
"created_at": "2026-05-11T12:16:44.817Z",
"frontend_resources": null,
"sequence": 72
}
],
"created_at": "2026-05-11T12:16:44.782Z",
"frontend_resources": null,
"sequence": 66
},
{
"permission_id": "sign-file-management",
"permission_name": "Design Files",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.81Z",
"frontend_resources": null,
"sequence": 75
}
],
"created_at": "2026-05-11T12:16:44.714Z",
"frontend_resources": null,
"sequence": 45
},
{
"permission_id": "analysis-management",
"permission_name": "Analyzer",
"permission_description": "",
"predecessor": [
"model-view",
"media-view",
"map-mark-view",
"sign-file-management"
],
"created_at": "2026-05-11T12:16:44.805Z",
"frontend_resources": [
"analysis-front"
],
"sequence": 73
},
{
"permission_id": "workflow-operation",
"permission_name": "Automated Workflow Operations",
"permission_description": "",
"predecessor": [
"view-plan",
"team-view-device",
"wayline-view",
"wayline-edit",
"operate-task",
"model-management",
"map-mark-management",
"media-management",
"analysis-management"
],
"created_at": "2026-05-11T12:16:44.808Z",
"frontend_resources": null,
"sequence": 74
},
{
"permission_id": "geo-areas-management",
"permission_name": "Geofence Area Management",
"permission_description": "",
"created_at": "2026-05-11T12:16:44.827Z",
"frontend_resources": null,
"sequence": 78
}
],
"roles_permissions": null
}
}🟠401
🟠403
🔴500
Modified at 2026-05-26 14:32:15