Documentation Index
Fetch the complete documentation index at: https://docs.cyberwave.com/llms.txt
Use this file to discover all available pages before exploring further.
cyberwave.rest.DefaultApi
All URIs are relative to http://localhost| Method | HTTP request | Description |
|---|---|---|
| src_app_api_alerts_acknowledge_alert | POST /api/v1/alerts/{uuid}/acknowledge | Acknowledge Alert |
| src_app_api_alerts_create_alert | POST /api/v1/alerts | Create Alert |
| src_app_api_alerts_delete_alert | DELETE /api/v1/alerts/{uuid} | Delete Alert |
| src_app_api_alerts_get_alert | GET /api/v1/alerts/{uuid} | Get Alert |
| src_app_api_alerts_list_alerts | GET /api/v1/alerts | List Alerts |
| src_app_api_alerts_resolve_alert | POST /api/v1/alerts/{uuid}/resolve | Resolve Alert |
| src_app_api_alerts_silence_alert | POST /api/v1/alerts/{uuid}/silence | Silence Alert |
| src_app_api_alerts_update_alert | PUT /api/v1/alerts/{uuid} | Update Alert |
| src_app_api_assets_check_registry_id_availability | GET /api/v1/assets/check-registry-id/{registry_id} | Check Registry Id Availability |
| src_app_api_assets_complete_large_glb_upload | POST /api/v1/assets/{uuid}/complete-large-glb-upload | Complete Large Glb Upload |
| src_app_api_assets_create_asset | POST /api/v1/assets | Create Asset |
| src_app_api_assets_create_asset_from_prompt_or_image | POST /api/v1/assets/create-from-prompt-or-image | Create Asset From Prompt Or Image |
| src_app_api_assets_create_asset_with_urdf | POST /api/v1/assets/create-with-urdf | Create Asset With Urdf |
| src_app_api_assets_delete_asset | DELETE /api/v1/assets/{uuid} | Delete Asset |
| src_app_api_assets_export_asset | GET /api/v1/assets/{uuid}/export | Export Asset |
| src_app_api_assets_get_asset | GET /api/v1/assets/{uuid} | Get Asset |
| src_app_api_assets_get_asset_controllers | GET /api/v1/assets/{uuid}/controllers | Get Asset Controllers |
| src_app_api_assets_get_asset_kinematics | GET /api/v1/assets/{uuid}/kinematics | Get Asset Kinematics |
| src_app_api_assets_get_asset_universal_schema | GET /api/v1/assets/{uuid}/universal-schema | Get Asset Universal Schema |
| src_app_api_assets_get_asset_universal_schema_at_path | GET /api/v1/assets/{uuid}/universal-schema/at | Get Asset Universal Schema At Path |
| src_app_api_assets_get_popular_tags | GET /api/v1/assets/popular-tags | Get Popular Tags |
| src_app_api_assets_get_public_vendors | GET /api/v1/assets/public-vendors | Get Public Vendors |
| src_app_api_assets_import_asset_package | POST /api/v1/assets/import | Import Asset Package |
| src_app_api_assets_import_catalog_asset | POST /api/v1/assets/import-catalog | Import Catalog Asset |
| src_app_api_assets_initiate_large_glb_upload | POST /api/v1/assets/{uuid}/initiate-large-glb-upload | Initiate Large Glb Upload |
| src_app_api_assets_list_assets | GET /api/v1/assets | List Assets |
| src_app_api_assets_llm_generation | POST /api/v1/assets/{uuid}/llm-generation | Llm Generation |
| src_app_api_assets_patch_asset_universal_schema | PATCH /api/v1/assets/{uuid}/universal-schema | Patch Asset Universal Schema |
| src_app_api_assets_rebuild_asset_universal_schema | POST /api/v1/assets/{uuid}/universal-schema/rebuild | Rebuild Asset Universal Schema |
| src_app_api_assets_set_glb_from_attachment | POST /api/v1/assets/{uuid}/glb-from-attachment | Set Glb From Attachment |
| src_app_api_assets_update_asset | PUT /api/v1/assets/{uuid} | Update Asset |
| src_app_api_assets_upload_glb | POST /api/v1/assets/{uuid}/glb-file | Upload Glb |
| src_app_api_assets_upload_thumbnail_file | POST /api/v1/assets/{uuid}/thumbnail-file | Upload Thumbnail File |
| src_app_api_assets_vlm_generation | POST /api/v1/assets/{uuid}/vlm-generation | Vlm Generation |
| src_app_api_attachments_complete_large_attachment_upload | POST /api/v1/attachments/{uuid}/complete-large-upload | Complete Large Attachment Upload |
| src_app_api_attachments_create_attachment | POST /api/v1/attachments | Create Attachment |
| src_app_api_attachments_delete_attachment | DELETE /api/v1/attachments/{uuid} | Delete Attachment |
| src_app_api_attachments_download_attachment | GET /api/v1/attachments/{uuid}/download | Download Attachment |
| src_app_api_attachments_get_attachment | GET /api/v1/attachments/{uuid} | Get Attachment |
| src_app_api_attachments_initiate_large_attachment_upload | POST /api/v1/attachments/{uuid}/initiate-large-upload | Initiate Large Attachment Upload |
| src_app_api_attachments_list_attachments | GET /api/v1/attachments | List Attachments |
| src_app_api_attachments_update_attachment | PUT /api/v1/attachments/{uuid} | Update Attachment |
| src_app_api_attachments_upload_attachment | POST /api/v1/attachments/{uuid}/upload | Upload Attachment |
| src_app_api_controller_policies_clone_controller_policy | POST /api/v1/controller-policies/{uuid}/clone | Clone Controller Policy |
| src_app_api_controller_policies_create_controller_policy | POST /api/v1/controller-policies | Create Controller Policy |
| src_app_api_controller_policies_delete_controller_policy | DELETE /api/v1/controller-policies/{uuid} | Delete Controller Policy |
| src_app_api_controller_policies_execute_controller_policy | POST /api/v1/controller-policies/{uuid}/execute | Execute Controller Policy |
| src_app_api_controller_policies_get_action_from_policy | GET /api/v1/controller-policies/{uuid}/action | Get Action From Policy |
| src_app_api_controller_policies_get_controller_policy | GET /api/v1/controller-policies/{uuid} | Get Controller Policy |
| src_app_api_controller_policies_list_controller_policies | GET /api/v1/controller-policies | List Controller Policies |
| src_app_api_controller_policies_update_controller_policy | PUT /api/v1/controller-policies/{uuid} | Update Controller Policy |
| src_app_api_datasets_create_dataset | POST /api/v1/datasets | Create Dataset |
| src_app_api_datasets_delete_dataset | DELETE /api/v1/datasets/{uuid} | Delete Dataset |
| src_app_api_datasets_get_dataset | GET /api/v1/datasets/{uuid} | Get Dataset |
| src_app_api_datasets_get_dataset_zip_url | GET /api/v1/datasets/{uuid}/zip | Get Dataset Zip Url |
| src_app_api_datasets_list_datasets | GET /api/v1/datasets | List Datasets |
| src_app_api_datasets_remove_episode_from_dataset | DELETE /api/v1/datasets/{uuid}/episodes/{episode_uuid} | Remove Episode From Dataset |
| src_app_api_datasets_update_dataset | PUT /api/v1/datasets/{uuid} | Update Dataset |
| src_app_api_edge_nodes_discover_twins | POST /api/v1/edges/discover | Discover Twins |
| src_app_api_edge_nodes_get_edge_twins | GET /api/v1/edges/{uuid}/twins | Get Edge Twins |
| src_app_api_edge_nodes_pair_twin_to_edge | POST /api/v1/edges/{uuid}/pair | Pair Twin To Edge |
| src_app_api_edge_nodes_restart_edge_core | POST /api/v1/edges/{uuid}/restart-core | Restart Edge Core |
| src_app_api_edge_nodes_unpair_twin_from_edge | DELETE /api/v1/edges/{uuid}/twins/{twin_uuid} | Unpair Twin From Edge |
| src_app_api_edge_nodes_update_camera_config | PUT /api/v1/edges/{uuid}/twins/{twin_uuid}/camera-config | Update Camera Config |
| src_app_api_edges_create_edge | POST /api/v1/edges | Create Edge |
| src_app_api_edges_delete_edge | DELETE /api/v1/edges/{uuid} | Delete Edge |
| src_app_api_edges_get_edge | GET /api/v1/edges/{uuid} | Get Edge |
| src_app_api_edges_get_edges | GET /api/v1/edges | Get Edges |
| src_app_api_edges_update_edge | PUT /api/v1/edges/{uuid} | Update Edge |
| src_app_api_environments_cancel_environment_invitation | DELETE /api/v1/environments/invitations/{invitation_uuid} | Cancel Environment Invitation |
| src_app_api_environments_create_environment_for_project | POST /api/v1/projects/{uuid}/environments | Create Environment For Project |
| src_app_api_environments_create_environment_link | POST /api/v1/environments/{uuid}/create-link | Create Environment Link |
| src_app_api_environments_create_environment_simulation | POST /api/v1/environments/{uuid}/simulations | Create Environment Simulation |
| src_app_api_environments_create_environment_snapshot | POST /api/v1/environments/{uuid}/snapshots | Create Environment Snapshot |
| src_app_api_environments_add_environment_waypoints | POST /api/v1/environments/{uuid}/waypoints | Add Environment Waypoints |
| src_app_api_environments_create_standalone_environment | POST /api/v1/environments | Create Standalone Environment |
| src_app_api_environments_delete_environment | DELETE /api/v1/environments/{uuid} | Delete Environment |
| src_app_api_environments_delete_environment_for_project | DELETE /api/v1/projects/{project_uuid}/environments/{uuid} | Delete Environment For Project |
| src_app_api_environments_delete_environment_snapshot | DELETE /api/v1/environments/{uuid}/snapshots/{snapshot_uuid} | Delete Environment Snapshot |
| src_app_api_environments_delete_environment_waypoint | DELETE /api/v1/environments/{uuid}/waypoints/{waypoint_id} | Delete Environment Waypoint |
| src_app_api_environments_delete_recording | DELETE /api/v1/environments/{uuid}/recordings/{recording_uuid} | Delete Recording |
| src_app_api_environments_generate_telemetry_recording | POST /api/v1/environments/{uuid}/generate-recording | Generate Telemetry Recording |
| src_app_api_environments_get_environment | GET /api/v1/environments/{uuid} | Get Environment |
| src_app_api_environments_get_environment_dirty_twins | GET /api/v1/environments/{uuid}/schema/dirty_twins | Get Environment Dirty Twins |
| src_app_api_environments_get_environment_waypoints | GET /api/v1/environments/{uuid}/waypoints | Get Environment Waypoints |
| src_app_api_environments_get_environment_invitations | GET /api/v1/environments/{uuid}/invitations | Get Environment Invitations |
| src_app_api_environments_get_environment_mujoco_scene | GET /api/v1/environments/{uuid}/mujoco-scene | Get Environment Mujoco Scene |
| src_app_api_environments_get_environment_mujoco_scene_xml | GET /api/v1/environments/{uuid}/mujoco-scene.xml | Get Environment Mujoco Scene Xml |
| src_app_api_environments_get_environment_mujoco_scene_zip_direct | GET /api/v1/environments/{uuid}/mujoco-scene.zip | Get Environment Mujoco Scene Zip Direct |
| src_app_api_environments_get_environment_recordings | GET /api/v1/environments/{uuid}/recordings | Get Environment Recordings |
| src_app_api_environments_get_environment_sessions | GET /api/v1/environments/{uuid}/sessions | Get Environment Sessions |
| src_app_api_environments_get_environment_sharing_info_endpoint | GET /api/v1/environments/{uuid}/sharing | Get Environment Sharing Info Endpoint |
| src_app_api_environments_get_environment_simulations | GET /api/v1/environments/{uuid}/simulations | Get Environment Simulations |
| src_app_api_environments_get_environment_snapshot | GET /api/v1/environments/{uuid}/snapshots/{snapshot_uuid} | Get Environment Snapshot |
| src_app_api_environments_get_environment_snapshot_hash | GET /api/v1/environments/{uuid}/snapshot-hash | Get Environment Snapshot Hash |
| src_app_api_environments_get_environment_twins | GET /api/v1/environments/{uuid}/twins | Get Environment Twins |
| src_app_api_environments_get_environment_universal_schema | GET /api/v1/environments/{uuid}/universal-schema | Get Environment Universal Schema |
| src_app_api_environments_get_environment_universal_schema_json | GET /api/v1/environments/{uuid}/universal-schema.json | Get Environment Universal Schema Json |
| src_app_api_environments_get_environment_urdf_bundle | GET /api/v1/environments/{uuid}/urdf-bundle | Get Environment Urdf Bundle |
| src_app_api_environments_get_environment_urdf_scene | GET /api/v1/environments/{uuid}/urdf-scene | Get Environment Urdf Scene |
| src_app_api_environments_get_environment_urdf_scene_zip_direct | GET /api/v1/environments/{uuid}/urdf-scene.zip | Get Environment Urdf Scene Zip Direct |
| src_app_api_environments_get_my_environment_permissions | GET /api/v1/environments/{uuid}/my-permissions | Get My Environment Permissions |
| src_app_api_environments_get_recording_data | GET /api/v1/environments/{uuid}/recordings/{recording_uuid}/data | Get Recording Data |
| src_app_api_environments_import_environment_mujoco_scene | POST /api/v1/environments/{uuid}/import/mujoco-scene | Import Environment Mujoco Scene |
| src_app_api_environments_import_environment_universal_schema | POST /api/v1/environments/{uuid}/import/universal-schema | Import Environment Universal Schema |
| src_app_api_environments_import_environment_urdf | POST /api/v1/environments/{uuid}/import/urdf | Import Environment Urdf |
| src_app_api_environments_invite_user_to_environment | POST /api/v1/environments/{uuid}/invite | Invite User To Environment |
| src_app_api_environments_list_all_environments | GET /api/v1/environments | List All Environments |
| src_app_api_environments_list_environment_mission_executions | GET /api/v1/environments/{uuid}/mission-executions | List Environment Mission Executions |
| src_app_api_environments_list_environment_snapshots | GET /api/v1/environments/{uuid}/snapshots | List Environment Snapshots |
| src_app_api_environments_list_environment_task_executions | GET /api/v1/environments/{uuid}/task-executions | List Environment Task Executions |
| src_app_api_environments_list_environments_for_project | GET /api/v1/projects/{uuid}/environments | List Environments For Project |
| src_app_api_environments_process_all_environment_sessions | POST /api/v1/environments/{uuid}/process-all-sessions | Process All Environment Sessions |
| src_app_api_environments_remove_user_from_environment | DELETE /api/v1/environments/{uuid}/users/{user_id} | Remove User From Environment |
| src_app_api_environments_reset_environment | POST /api/v1/environments/{uuid}/reset | Reset Environment |
| src_app_api_environments_restore_environment_snapshot | PUT /api/v1/environments/{uuid}/snapshots/{snapshot_uuid}/restore | Restore Environment Snapshot |
| src_app_api_environments_revoke_environment_link | POST /api/v1/environments/{uuid}/revoke-link | Revoke Environment Link |
| src_app_api_environments_share_environment_with_user | POST /api/v1/environments/{uuid}/share | Share Environment With User |
| src_app_api_environments_stop_environment_simulation | POST /api/v1/environments/{uuid}/simulations/{simulation_id}/stop | Stop Environment Simulation |
| src_app_api_environments_update_environment | PUT /api/v1/environments/{uuid} | Update Environment |
| src_app_api_environments_update_environment_for_project | PUT /api/v1/projects/{project_uuid}/environments/{uuid} | Update Environment For Project |
| src_app_api_environments_update_environment_snapshot | PUT /api/v1/environments/{uuid}/snapshots/{snapshot_uuid} | Update Environment Snapshot |
| src_app_api_environments_update_recording_metadata | PUT /api/v1/environments/{uuid}/recordings/{recording_uuid} | Update Recording Metadata |
| src_app_api_episode_create_episode | POST /api/v1/episodes | Create Episode |
| src_app_api_episode_delete_episode | DELETE /api/v1/episodes/{uuid} | Delete Episode |
| src_app_api_episode_get_episode | GET /api/v1/episodes/{uuid} | Get Episode |
| src_app_api_episode_list_episode_task_names | GET /api/v1/episodes/task-names | List Episode Task Names |
| src_app_api_episode_list_episodes | GET /api/v1/episodes | List Episodes |
| src_app_api_episode_update_episode | PUT /api/v1/episodes/{uuid} | Update Episode |
| src_app_api_events_create_business_event | POST /api/v1/events | Create Business Event |
| src_app_api_events_list_live_events | GET /api/v1/events/live | List Live Events |
| src_app_api_executions_get_task_execution | GET /api/v1/executions/{uuid} | Get Task Execution |
| src_app_api_executions_list_task_executions | GET /api/v1/executions | List Task Executions |
| src_app_api_invitation_router_accept_invitation_endpoint | GET /api/v1/invitations/accept/{token} | Accept Invitation Endpoint |
| src_app_api_invitation_router_get_invitation_info | GET /api/v1/invitations/info/{token} | Get Invitation Info |
| src_app_api_keybindings_create_keybinding | POST /api/v1/keybindings | Create Keybinding |
| src_app_api_keybindings_delete_keybinding | DELETE /api/v1/keybindings/{uuid} | Delete Keybinding |
| src_app_api_keybindings_get_keybinding | GET /api/v1/keybindings/{uuid} | Get Keybinding |
| src_app_api_keybindings_list_keybindings | GET /api/v1/keybindings | List Keybindings |
| src_app_api_keybindings_update_keybinding | PUT /api/v1/keybindings/{uuid} | Update Keybinding |
| src_app_api_labs_admin_force_end_session | DELETE /api/v1/labs/milan-so101/admin/sessions/{session_uuid} | Admin Force End Session |
| src_app_api_labs_end_milan_lab_session | DELETE /api/v1/labs/milan-so101/end-session | End Milan Lab Session |
| src_app_api_labs_get_admin_lab_overview | GET /api/v1/labs/milan-so101/admin/sessions | Get Admin Lab Overview |
| src_app_api_labs_get_milan_lab_status | GET /api/v1/labs/milan-so101/status | Get Milan Lab Status |
| src_app_api_labs_request_milan_lab_access | POST /api/v1/labs/milan-so101/request-access | Request Milan Lab Access |
| src_app_api_maps_create_map | POST /api/v1/maps | Create Map |
| src_app_api_maps_delete_map | DELETE /api/v1/maps/{uuid} | Delete Map |
| src_app_api_maps_download_map_data | GET /api/v1/maps/{uuid}/data | Download Map Data |
| src_app_api_maps_finalize_stream_map | POST /api/v1/maps/{uuid}/stream-finalize | Finalize Stream Map |
| src_app_api_maps_get_map | GET /api/v1/maps/{uuid} | Get Map |
| src_app_api_maps_get_map_image | GET /api/v1/maps/{uuid}/image | Get Map Image |
| src_app_api_maps_list_environment_maps | GET /api/v1/maps/environments/{uuid} | List Environment Maps |
| src_app_api_maps_list_maps | GET /api/v1/maps | List Maps |
| src_app_api_maps_list_twin_maps | GET /api/v1/maps/twins/{uuid} | List Twin Maps |
| src_app_api_maps_start_map_from_stream | POST /api/v1/maps/stream-start | Start Map From Stream |
| src_app_api_maps_stop_map_from_stream | POST /api/v1/maps/stream-stop | Stop Map From Stream |
| src_app_api_missions_cancel_mission_execution | POST /api/v1/twins/{twin_uuid}/missions/{mission_uuid}/executions/{uuid}/cancel | Cancel Mission Execution |
| src_app_api_missions_create_mission | POST /api/v1/twins/{uuid}/missions | Create Mission |
| src_app_api_missions_delete_mission | DELETE /api/v1/twins/{twin_uuid}/missions/{uuid} | Delete Mission |
| src_app_api_missions_execute_mission | POST /api/v1/twins/{twin_uuid}/missions/{uuid}/execute | Execute Mission |
| src_app_api_missions_get_mission | GET /api/v1/twins/{twin_uuid}/missions/{uuid} | Get Mission |
| src_app_api_missions_get_mission_execution | GET /api/v1/twins/{twin_uuid}/missions/{mission_uuid}/executions/{uuid} | Get Mission Execution |
| src_app_api_missions_list_mission_executions | GET /api/v1/twins/{twin_uuid}/missions/{uuid}/executions | List Mission Executions |
| src_app_api_missions_list_missions | GET /api/v1/twins/{uuid}/missions | List Missions |
| src_app_api_mlmodels_create_mlmodel | POST /api/v1/mlmodels | Create Mlmodel |
| src_app_api_mlmodels_delete_mlmodel | DELETE /api/v1/mlmodels/{uuid} | Delete Mlmodel |
| src_app_api_mlmodels_get_mlmodel | GET /api/v1/mlmodels/{uuid} | Get Mlmodel |
| src_app_api_mlmodels_get_mlmodel_weights | GET /api/v1/mlmodels/{uuid}/weights | Get Mlmodel Weights |
| src_app_api_mlmodels_list_mlmodels | GET /api/v1/mlmodels | List Mlmodels |
| src_app_api_mlmodels_update_mlmodel | PUT /api/v1/mlmodels/{uuid} | Update Mlmodel |
| src_app_api_mltrainings_create_mltraining | POST /api/v1/mltrainings | Create Mltraining |
| src_app_api_mltrainings_delete_mltraining | DELETE /api/v1/mltrainings/{uuid} | Delete Mltraining |
| src_app_api_mltrainings_deploy_mltraining | POST /api/v1/mltrainings/{uuid}/deploy | Deploy Mltraining |
| src_app_api_mltrainings_get_deployed_mltrainings | GET /api/v1/mltrainings/deployed | Get Deployed Mltrainings |
| src_app_api_mltrainings_get_mltraining | GET /api/v1/mltrainings/{uuid} | Get Mltraining |
| src_app_api_mltrainings_list_mltrainings_for_user_workspaces | GET /api/v1/mltrainings | List Mltrainings For User Workspaces |
| src_app_api_mltrainings_update_mltraining | PUT /api/v1/mltrainings/{uuid} | Update Mltraining |
| src_app_api_navigation_execute_twin_navigation | POST /api/v1/twins/{uuid}/navigation | Execute Twin Navigation |
| src_app_api_projects_create_project | POST /api/v1/projects | Create Project |
| src_app_api_projects_create_project_link | POST /api/v1/projects/{uuid}/create-link | Create Project Link |
| src_app_api_projects_delete_project | DELETE /api/v1/projects/{uuid} | Delete Project |
| src_app_api_projects_get_my_project_permissions | GET /api/v1/projects/{uuid}/my-permissions | Get My Project Permissions |
| src_app_api_projects_get_project | GET /api/v1/projects/{uuid} | Get Project |
| src_app_api_projects_get_project_shares | GET /api/v1/projects/{uuid}/shares | Get Project Shares |
| src_app_api_projects_invite_user_to_project | POST /api/v1/projects/{uuid}/invite | Invite User To Project |
| src_app_api_projects_list_projects | GET /api/v1/projects | List Projects |
| src_app_api_projects_revoke_project_link | POST /api/v1/projects/{uuid}/revoke-link | Revoke Project Link |
| src_app_api_projects_share_project | POST /api/v1/projects/{uuid}/share | Share Project |
| src_app_api_projects_unshare_project | POST /api/v1/projects/{uuid}/unshare | Unshare Project |
| src_app_api_projects_update_project | PUT /api/v1/projects/{uuid} | Update Project |
| src_app_api_tagged_frames_create_tagged_frames | POST /api/v1/tagged-frames | Create Tagged Frames |
| src_app_api_tagged_frames_delete_tagged_frames | DELETE /api/v1/tagged-frames/{uuid} | Delete Tagged Frames |
| src_app_api_tagged_frames_get_tagged_frames | GET /api/v1/tagged-frames/{uuid} | Get Tagged Frames |
| src_app_api_tagged_frames_list_tagged_frames | GET /api/v1/tagged-frames | List Tagged Frames |
| src_app_api_tagged_frames_update_tagged_frames | PUT /api/v1/tagged-frames/{uuid} | Update Tagged Frames |
| src_app_api_tasks_cancel_task_execution | POST /api/v1/tasks/executions/{uuid}/cancel | Cancel Task Execution |
| src_app_api_tasks_create_task | POST /api/v1/tasks | Create Task |
| src_app_api_tasks_delete_task | DELETE /api/v1/tasks/{uuid} | Delete Task |
| src_app_api_tasks_execute_task | POST /api/v1/tasks/{uuid}/execute | Execute Task |
| src_app_api_tasks_get_task | GET /api/v1/tasks/{uuid} | Get Task |
| src_app_api_tasks_get_task_execution | GET /api/v1/tasks/executions/{uuid} | Get Task Execution |
| src_app_api_tasks_list_task_queue | GET /api/v1/tasks/queue | List Task Queue |
| src_app_api_tasks_list_tasks | GET /api/v1/tasks | List Tasks |
| src_app_api_tasks_update_task | PUT /api/v1/tasks/{uuid} | Update Task |
| src_app_api_twins_create_twin | POST /api/v1/twins | Create Twin |
| src_app_api_twins_delete_twin | DELETE /api/v1/twins/{uuid} | Delete Twin |
| src_app_api_twins_execute_twin_action | POST /api/v1/twins/{uuid}/actions | Execute Twin Action |
| src_app_api_twins_get_recording | GET /api/v1/twins/recordings/{recording_uuid} | Get Recording |
| src_app_api_twins_get_twin | GET /api/v1/twins/{uuid} | Get Twin |
| src_app_api_twins_get_twin_action_status | GET /api/v1/twins/{uuid}/actions/{action_id} | Get Twin Action Status |
| src_app_api_twins_get_twin_calibration | GET /api/v1/twins/{uuid}/calibration | Get Twin Calibration |
| src_app_api_twins_get_twin_connection_history | GET /api/v1/twins/{uuid}/connection-history | Get Twin Connection History |
| src_app_api_twins_get_twin_driver_logs | GET /api/v1/twins/{uuid}/logs | Get Twin Driver Logs |
| src_app_api_twins_get_twin_latest_frame | GET /api/v1/twins/{uuid}/latest-frame | Get Twin Latest Frame |
| src_app_api_twins_get_twin_latest_metrics | GET /api/v1/twins/{uuid}/metrics/latest | Get Twin Latest Metrics |
| src_app_api_twins_get_twin_links | GET /api/v1/twins/{uuid}/links | Get Twin Links |
| src_app_api_twins_get_twin_metrics | GET /api/v1/twins/{uuid}/metrics | Get Twin Metrics |
| src_app_api_twins_get_twin_motions | GET /api/v1/twins/{uuid}/motions | Get Twin Motions |
| src_app_api_twins_get_twin_notebook | GET /api/v1/twins/{uuid}/notebook.ipynb | Get Twin Notebook |
| src_app_api_twins_get_twin_recordings | GET /api/v1/twins/{uuid}/recordings | Get Twin Recordings |
| src_app_api_twins_get_twin_relationships | GET /api/v1/twins/{uuid}/relationships | Get Twin Relationships |
| src_app_api_twins_get_twin_universal_schema_at_path | GET /api/v1/twins/{uuid}/universal-schema/at | Get Twin Universal Schema At Path |
| src_app_api_twins_link_occupancy_map | POST /api/v1/twins/{uuid}/occupancy-map | Link Occupancy Map |
| src_app_api_twins_list_all_twins | GET /api/v1/twins | List All Twins |
| src_app_api_twins_patch_twin_universal_schema | PATCH /api/v1/twins/{uuid}/universal-schema | Patch Twin Universal Schema |
| src_app_api_twins_reload_twin_capabilities | POST /api/v1/twins/{uuid}/reload-capabilities | Reload Twin Capabilities |
| src_app_api_twins_reload_twins_capabilities_bulk | POST /api/v1/twins/reload-capabilities | Reload Twins Capabilities Bulk |
| src_app_api_twins_sync_twin_with_asset | POST /api/v1/twins/{uuid}/sync-with-asset | Sync Twin With Asset |
| src_app_api_twins_update_twin | PUT /api/v1/twins/{uuid} | Update Twin |
| src_app_api_twins_update_twin_calibration | POST /api/v1/twins/{uuid}/calibration | Update Twin Calibration |
| src_app_api_twins_update_twin_state | PATCH /api/v1/twins/{uuid}/state | Update Twin State |
| src_app_api_urdf_create_urdf_project | POST /api/v1/urdf-projects | Create Urdf Project |
| src_app_api_urdf_delete_urdf_project | DELETE /api/v1/urdf-projects/{uuid} | Delete Urdf Project |
| src_app_api_urdf_fix_urdf_project_slug | POST /api/v1/urdf-projects/{uuid}/fix-slug | Fix Urdf Project Slug |
| src_app_api_urdf_get_twin_joint_state | GET /api/v1/twins/{uuid}/joints/{joint_name}/state | Get Twin Joint State |
| src_app_api_urdf_get_twin_joint_states | GET /api/v1/twins/{uuid}/joint_states | Get Twin Joint States |
| src_app_api_urdf_get_twin_joints | GET /api/v1/twins/{uuid}/joints | Get Twin Joints |
| src_app_api_urdf_get_twin_robot_description | GET /api/v1/twins/{uuid}/robot_description | Get Twin Robot Description |
| src_app_api_urdf_get_twin_urdf_raw | GET /api/v1/twins/{uuid}/urdf | Get Twin Urdf Raw |
| src_app_api_urdf_get_urdf_project | GET /api/v1/urdf-projects/{uuid} | Get Urdf Project |
| src_app_api_urdf_list_urdf_projects | GET /api/v1/urdf-projects | List Urdf Projects |
| src_app_api_urdf_update_twin_joint_state | PUT /api/v1/twins/{uuid}/joints/{joint_name}/state | Update Twin Joint State |
| src_app_api_urdf_update_twin_joint_states | PUT /api/v1/twins/{uuid}/joint_states | Update Twin Joint States |
| src_app_api_urdf_update_urdf_project | PUT /api/v1/urdf-projects/{uuid} | Update Urdf Project |
| src_app_api_urdf_upload_zip_file | POST /api/v1/urdf-projects/{uuid}/zip-file | Upload Zip File |
| src_app_api_workflows_activate_workflow | POST /api/v1/workflows/{uuid}/activate | Activate Workflow |
| src_app_api_workflows_cancel_workflow_execution | POST /api/v1/workflows/executions/{execution_uuid}/cancel | Cancel Workflow Execution |
| src_app_api_workflows_create_workflow | POST /api/v1/workflows | Create Workflow |
| src_app_api_workflows_create_workflow_connection | POST /api/v1/workflows/{uuid}/connections | Create Workflow Connection |
| src_app_api_workflows_create_workflow_node | POST /api/v1/workflows/{uuid}/nodes | Create Workflow Node |
| src_app_api_workflows_deactivate_workflow | POST /api/v1/workflows/{uuid}/deactivate | Deactivate Workflow |
| src_app_api_workflows_delete_workflow | DELETE /api/v1/workflows/{uuid} | Delete Workflow |
| src_app_api_workflows_delete_workflow_connection | DELETE /api/v1/workflows/{uuid}/connections/{connection_uuid} | Delete Workflow Connection |
| src_app_api_workflows_delete_workflow_node | DELETE /api/v1/workflows/{uuid}/nodes/{node_uuid} | Delete Workflow Node |
| src_app_api_workflows_edge_sync_workflows | GET /api/v1/workflows/edge-sync/{twin_uuid} | Edge Sync Workflows |
| src_app_api_workflows_execute_workflow | POST /api/v1/workflows/{uuid}/execute | Execute Workflow |
| src_app_api_workflows_get_execution_by_uuid | GET /api/v1/workflows/executions/{execution_uuid} | Get Execution By Uuid |
| src_app_api_workflows_get_node_schema | GET /api/v1/workflows/node-schemas/{node_type} | Get Node Schema |
| src_app_api_workflows_get_node_schemas | GET /api/v1/workflows/node-schemas | Get Node Schemas |
| src_app_api_workflows_get_workflow | GET /api/v1/workflows/{uuid} | Get Workflow |
| src_app_api_workflows_get_workflow_execution | GET /api/v1/workflows/{uuid}/executions/{execution_uuid} | Get Workflow Execution |
| src_app_api_workflows_get_workflow_node | GET /api/v1/workflows/{uuid}/nodes/{node_uuid} | Get Workflow Node |
| src_app_api_workflows_list_workflow_connections | GET /api/v1/workflows/{uuid}/connections | List Workflow Connections |
| src_app_api_workflows_list_workflow_executions | GET /api/v1/workflows/{uuid}/executions | List Workflow Executions |
| src_app_api_workflows_list_workflow_nodes | GET /api/v1/workflows/{uuid}/nodes | List Workflow Nodes |
| src_app_api_workflows_list_workflows | GET /api/v1/workflows | List Workflows |
| src_app_api_workflows_update_workflow | PUT /api/v1/workflows/{uuid} | Update Workflow |
| src_app_api_workflows_update_workflow_node | PUT /api/v1/workflows/{uuid}/nodes/{node_uuid} | Update Workflow Node |
| src_app_api_workflows_validate_node_inputs | POST /api/v1/workflows/nodes/{node_uuid}/validate-inputs | Validate Node Inputs |
| src_users_api_organizations_add_organization_member_by_email | POST /api/v1/users/organizations/{uuid}/members | Add Organization Member By Email |
| src_users_api_organizations_create_organization | POST /api/v1/users/organizations | Create Organization |
| src_users_api_organizations_delete_organization | DELETE /api/v1/users/organizations/{uuid} | Delete Organization |
| src_users_api_organizations_get_organization | GET /api/v1/users/organizations/{uuid} | Get Organization |
| src_users_api_organizations_get_organization_by_slug | GET /api/v1/users/organizations/by-slug/{slug} | Get Organization By Slug |
| src_users_api_organizations_list_organization_members | GET /api/v1/users/organizations/{uuid}/members | List Organization Members |
| src_users_api_organizations_list_organization_workspaces | GET /api/v1/users/organizations/{uuid}/workspaces | List Organization Workspaces |
| src_users_api_organizations_list_organizations | GET /api/v1/users/organizations | List Organizations |
| src_users_api_organizations_remove_organization_member | DELETE /api/v1/users/organizations/{uuid}/members/{user_uuid} | Remove Organization Member |
| src_users_api_organizations_update_organization | PUT /api/v1/users/organizations/{uuid} | Update Organization |
| src_users_api_organizations_update_organization_member_role | PUT /api/v1/users/organizations/{uuid}/members/{user_uuid}/role | Update Organization Member Role |
| src_users_api_plans_get_plan | GET /api/v1/users/plan | Get Plan |
| src_users_api_workspaces_add_workspace_member_by_email | POST /api/v1/users/workspaces/{uuid}/add-member | Add Workspace Member By Email |
| src_users_api_workspaces_check_workspace_slug | GET /api/v1/users/workspaces/check-slug/{slug} | Check Workspace Slug |
| src_users_api_workspaces_create_workspace | POST /api/v1/users/workspaces | Create Workspace |
| src_users_api_workspaces_delete_workspace | DELETE /api/v1/users/workspaces/{uuid} | Delete Workspace |
| src_users_api_workspaces_get_default_workspace | GET /api/v1/users/workspaces/default | Get Default Workspace |
| src_users_api_workspaces_get_vendor_description | GET /api/v1/users/vendors/{slug}/description | Get Vendor Description |
| src_users_api_workspaces_get_workspace | GET /api/v1/users/workspaces/{uuid} | Get Workspace |
| src_users_api_workspaces_get_workspace_by_slug | GET /api/v1/users/workspaces/by-slug/{slug} | Get Workspace By Slug |
| src_users_api_workspaces_leave_team | DELETE /api/v1/users/workspaces/{team_uuid}/members/{uuid}/leave | Leave Team |
| src_users_api_workspaces_list_team_members | GET /api/v1/users/workspaces/{team_uuid}/members | List Team Members |
| src_users_api_workspaces_list_workspaces | GET /api/v1/users/workspaces | List Workspaces |
| src_users_api_workspaces_remove_team_member | DELETE /api/v1/users/workspaces/{team_uuid}/members/{uuid} | Remove Team Member |
| src_users_api_workspaces_remove_workspace_member | DELETE /api/v1/users/workspaces/{uuid}/members/{user_uuid} | Remove Workspace Member |
| src_users_api_workspaces_set_default_workspace | POST /api/v1/users/workspaces/default | Set Default Workspace |
| src_users_api_workspaces_update_workspace | PUT /api/v1/users/workspaces/{uuid} | Update Workspace |
| src_users_api_workspaces_update_workspace_member_role | PUT /api/v1/users/workspaces/{uuid}/members/{user_uuid}/role | Update Workspace Member Role |
src_app_api_alerts_acknowledge_alert
AlertSchema src_app_api_alerts_acknowledge_alert(uuid)Acknowledge Alert Mark an alert as acknowledged.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_create_alert
AlertSchema src_app_api_alerts_create_alert(create_alert_schema)Create Alert Create a new alert.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| create_alert_schema | CreateAlertSchema |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_delete_alert
src_app_api_alerts_delete_alert(uuid)Delete Alert Delete an alert.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_get_alert
AlertSchema src_app_api_alerts_get_alert(uuid)Get Alert Get an alert by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_list_alerts
List[AlertSchema] src_app_api_alerts_list_alerts(workspace_uuid=workspace_uuid, twin_uuid=twin_uuid, environment_uuid=environment_uuid, status=status, severity=severity, limit=limit)List Alerts List alerts visible to the authenticated user. Filters:
- workspace_uuid: Filter by workspace
- twin_uuid: Filter by twin
- environment_uuid: Filter by environment
- status: Filter by status (comma-separated, e.g. “active,acknowledged”)
- severity: Filter by severity (comma-separated, e.g. “error,critical”)
- limit: Max results (default 100)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workspace_uuid | str | [optional] | |
| twin_uuid | str | [optional] | |
| environment_uuid | str | [optional] | |
| status | str | [optional] | |
| severity | str | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
List[AlertSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_resolve_alert
AlertSchema src_app_api_alerts_resolve_alert(uuid)Resolve Alert Mark an alert as resolved.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_silence_alert
AlertSchema src_app_api_alerts_silence_alert(uuid)Silence Alert Silence an alert workspace-wide without resolving the root cause.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_alerts_update_alert
AlertSchema src_app_api_alerts_update_alert(uuid, update_alert_schema)Update Alert Update an alert’s mutable fields.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| update_alert_schema | UpdateAlertSchema |
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_check_registry_id_availability
src_app_api_assets_check_registry_id_availability(registry_id)Check Registry Id Availability Check if a registry_id is available for use. Returns: - available: True if the registry_id is not in use - registry_id: The normalized registry_id - suggestion: If not available, suggests an alternative
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| registry_id | str |
Return type
void (empty response body)Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_complete_large_glb_upload
AssetSchema src_app_api_assets_complete_large_glb_upload(uuid, complete_large_upload_schema)Complete Large Glb Upload Complete a large GLB file upload for an asset. This moves the uploaded file to the asset’s GLB field.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| complete_large_upload_schema | CompleteLargeUploadSchema |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_create_asset
AssetSchema src_app_api_assets_create_asset(asset_create_schema)Create Asset
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| asset_create_schema | AssetCreateSchema |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_create_asset_from_prompt_or_image
DeferredTaskExecutionResponseSchema src_app_api_assets_create_asset_from_prompt_or_image(asset_name, prompt=prompt, image_url=image_url, image_bytes=image_bytes, description=description, workspace_uuid=workspace_uuid, visibility=visibility)Create Asset From Prompt Or Image Create a mesh from a text prompt (and optionally an image).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| asset_name | str | ||
| prompt | str | [optional] | |
| image_url | str | [optional] | |
| image_bytes | ImageBytes | [optional] | |
| description | str | [optional] | |
| workspace_uuid | str | [optional] | |
| visibility | str | [optional] [default to ‘private’] |
Return type
DeferredTaskExecutionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/x-www-form-urlencoded
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_create_asset_with_urdf
src_app_api_assets_create_asset_with_urdf(asset_create_with_urdf_schema)Create Asset With Urdf
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| asset_create_with_urdf_schema | AssetCreateWithURDFSchema |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_delete_asset
src_app_api_assets_delete_asset(uuid)Delete Asset
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_export_asset
src_app_api_assets_export_asset(uuid)Export Asset Export an asset as a .cbw package (zip file). The .cbw package contains all asset data including:
- Asset metadata, capabilities, and kinematics
- GLB visualization file (if present)
- Thumbnail (if present)
- URDF project files (if present)
- Attachments (if present)
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_asset
AssetSchema src_app_api_assets_get_asset(uuid)Get Asset Get an asset by UUID or registry_id. Supports both authenticated and anonymous access (for public assets).
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AssetSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_asset_controllers
List[ControllerPolicySchema] src_app_api_assets_get_asset_controllers(uuid)Get Asset Controllers
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[ControllerPolicySchema]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_asset_kinematics
Dict[str, object] src_app_api_assets_get_asset_kinematics(uuid)Get Asset Kinematics Get asset kinematics by UUID or registry_id. Supports both authenticated and anonymous access (for public assets).
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_asset_universal_schema
Dict[str, object] src_app_api_assets_get_asset_universal_schema(uuid)Get Asset Universal Schema Get the asset’s universal schema as JSON (for download). Supports both authenticated and anonymous access (for public assets).
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_asset_universal_schema_at_path
Dict[str, object] src_app_api_assets_get_asset_universal_schema_at_path(uuid, path=path)Get Asset Universal Schema At Path Get value at a specific JSON Pointer path in the asset’s universal schema. Supports both authenticated and anonymous access (for public assets). Query params: path: JSON Pointer path (e.g., /sensors/0, /extensions/cyberwave/capabilities) Returns:
{"path": "...", "value": <any json>}
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| path | str | [optional] [default to ”] |
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_popular_tags
PopularTagsResponseSchema src_app_api_assets_get_popular_tags()Get Popular Tags Get the most popular tags from asset metadata. Results are cached for 1 hour for performance.
Example
Parameters
This endpoint does not need any parameter.Return type
PopularTagsResponseSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_get_public_vendors
List[Optional[str]] src_app_api_assets_get_public_vendors()Get Public Vendors Get the list of vendors that have public assets. Used by frontend to whitelist vendor pages for unauthenticated access. Results are cached for 1 hour for performance.
Example
Parameters
This endpoint does not need any parameter.Return type
List[Optional[str]]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_import_asset_package
AssetSchema src_app_api_assets_import_asset_package(file, workspace_uuid=workspace_uuid, custom_registry_id=custom_registry_id)Import Asset Package Import an asset from a .cbw package file. The .cbw package should be a zip file created by the export endpoint, containing manifest.json, asset.json, and associated files. This allows transferring assets between Cyberwave instances. Parameters: file: The .cbw file to import workspace_uuid: Optional target workspace UUID. If not provided, uses user’s first workspace. custom_registry_id: Optional custom registry ID for the imported asset. If not provided, uses the original registry_id from the package.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| file | bytearray | ||
| workspace_uuid | str | [optional] | |
| custom_registry_id | str | [optional] |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_import_catalog_asset
AssetSchema src_app_api_assets_import_catalog_asset(asset_catalog_import_schema)Import Catalog Asset
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| asset_catalog_import_schema | AssetCatalogImportSchema |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_initiate_large_glb_upload
InitiateLargeUploadResponse src_app_api_assets_initiate_large_glb_upload(uuid, initiate_large_upload_schema)Initiate Large Glb Upload Initiate a large GLB file upload for an asset using Google Cloud signed URLs. This endpoint supports GLB files larger than 32MB.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| initiate_large_upload_schema | InitiateLargeUploadSchema |
Return type
InitiateLargeUploadResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_list_assets
List[AssetListSchema] src_app_api_assets_list_assets()List Assets
Example
Parameters
This endpoint does not need any parameter.Return type
List[AssetListSchema]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_llm_generation
LLMResponseSchema src_app_api_assets_llm_generation(uuid, llm_generation_schema)Llm Generation
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| llm_generation_schema | LLMGenerationSchema |
Return type
LLMResponseSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_patch_asset_universal_schema
Dict[str, object] src_app_api_assets_patch_asset_universal_schema(uuid, universal_schema_patch_schema)Patch Asset Universal Schema Update the asset’s universal schema using JSON Pointer operations. This allows editing the asset schema, including:
- /sensors (array of sensor objects)
- /extensions/cyberwave/capabilities
- /links, /joints, /actuators, etc.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| universal_schema_patch_schema | UniversalSchemaPatchSchema |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_rebuild_asset_universal_schema
Dict[str, object] src_app_api_assets_rebuild_asset_universal_schema(uuid, sync=sync)Rebuild Asset Universal Schema Trigger regeneration of an Asset’s universal_schema from its URDFProject. By default, queues a Celery task and returns immediately. Pass
?sync=true
to execute synchronously and block until complete (useful for local testing).
Returns:
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| sync | bool | [optional] [default to False] |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_set_glb_from_attachment
AssetSchema src_app_api_assets_set_glb_from_attachment(uuid, asset_glb_from_attachment_schema)Set Glb From Attachment Set an asset’s GLB file from an existing attachment. This is useful for processing workflows where an uploaded attachment gets converted/processed into the main GLB visualization file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| asset_glb_from_attachment_schema | AssetGLBFromAttachmentSchema |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_update_asset
AssetSchema src_app_api_assets_update_asset(uuid, asset_update_schema)Update Asset Update an asset by UUID or registry_id.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| asset_update_schema | AssetUpdateSchema |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_upload_glb
AssetSchema src_app_api_assets_upload_glb(uuid, file)Upload Glb
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_upload_thumbnail_file
AssetSchema src_app_api_assets_upload_thumbnail_file(uuid, file)Upload Thumbnail File
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray |
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_assets_vlm_generation
VLMResponseSchema src_app_api_assets_vlm_generation(uuid, vlm_generation_schema)Vlm Generation Generate a response using a Vision Language Model (VLM) with the given prompt and image. This endpoint uses Google’s Gemini 3 Pro vision model to analyze images and generate text responses based on the provided prompt. Args: request: The HTTP request uuid: The asset UUID (currently unused but kept for API consistency) payload: Contains the prompt and image_url to analyze Returns: VLMResponseSchema with the model’s text response
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| vlm_generation_schema | VLMGenerationSchema |
Return type
VLMResponseSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_complete_large_attachment_upload
AttachmentSchema src_app_api_attachments_complete_large_attachment_upload(uuid, complete_large_upload_schema)Complete Large Attachment Upload Complete a large file upload for an attachment. This marks the uploaded file as the attachment’s file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| complete_large_upload_schema | CompleteLargeUploadSchema |
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_create_attachment
AttachmentSchema src_app_api_attachments_create_attachment(attachment_create_schema)Create Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| attachment_create_schema | AttachmentCreateSchema |
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_delete_attachment
src_app_api_attachments_delete_attachment(uuid)Delete Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_download_attachment
src_app_api_attachments_download_attachment(uuid)Download Attachment Download attachment file content.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_get_attachment
AttachmentSchema src_app_api_attachments_get_attachment(uuid)Get Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_initiate_large_attachment_upload
InitiateLargeUploadResponse src_app_api_attachments_initiate_large_attachment_upload(uuid, initiate_large_upload_schema)Initiate Large Attachment Upload Initiate a large file upload for an attachment using Google Cloud signed URLs. This endpoint supports files larger than 32MB.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| initiate_large_upload_schema | InitiateLargeUploadSchema |
Return type
InitiateLargeUploadResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_list_attachments
List[AttachmentSchema] src_app_api_attachments_list_attachments()List Attachments
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[AttachmentSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_update_attachment
AttachmentSchema src_app_api_attachments_update_attachment(uuid, attachment_create_schema)Update Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| attachment_create_schema | AttachmentCreateSchema |
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_attachments_upload_attachment
AttachmentSchema src_app_api_attachments_upload_attachment(uuid, file)Upload Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray |
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_clone_controller_policy
ControllerPolicySchema src_app_api_controller_policies_clone_controller_policy(uuid, workspace_uuid=workspace_uuid)Clone Controller Policy Clone a controller policy into the specified workspace (or user’s default workspace).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workspace_uuid | str | [optional] |
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_create_controller_policy
ControllerPolicySchema src_app_api_controller_policies_create_controller_policy(controller_policy_create_schema)Create Controller Policy Create a new controller policy.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| controller_policy_create_schema | ControllerPolicyCreateSchema |
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_delete_controller_policy
Dict[str, Optional[bool]] src_app_api_controller_policies_delete_controller_policy(uuid)Delete Controller Policy Delete a controller policy.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_execute_controller_policy
ControllerPolicyExecuteResponseSchema src_app_api_controller_policies_execute_controller_policy(uuid, controller_policy_execute_schema)Execute Controller Policy
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| controller_policy_execute_schema | ControllerPolicyExecuteSchema |
Return type
ControllerPolicyExecuteResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_get_action_from_policy
str src_app_api_controller_policies_get_action_from_policy(uuid, instruction, twin_uuid, camera_twin_uuid)Get Action From Policy Get action from an ML model policy based on instruction and twin state. Validates that the twins exist and the camera is live, then dispatches the actual execution to a Celery worker.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| instruction | str | ||
| twin_uuid | str | ||
| camera_twin_uuid | str |
Return type
strAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_get_controller_policy
ControllerPolicySchema src_app_api_controller_policies_get_controller_policy(uuid)Get Controller Policy Get a specific controller policy by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_list_controller_policies
List[ControllerPolicySchema] src_app_api_controller_policies_list_controller_policies(asset_uuid=asset_uuid, workspace_uuid=workspace_uuid)List Controller Policies List all controller policies visible to the authenticated user, optionally filtered by asset and workspace.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| asset_uuid | str | [optional] | |
| workspace_uuid | str | [optional] |
Return type
List[ControllerPolicySchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_controller_policies_update_controller_policy
ControllerPolicySchema src_app_api_controller_policies_update_controller_policy(uuid, controller_policy_update_schema)Update Controller Policy Update an existing controller policy.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| controller_policy_update_schema | ControllerPolicyUpdateSchema |
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_create_dataset
Dict[str, object] src_app_api_datasets_create_dataset(dataset_create_schema)Create Dataset Create a new dataset. This starts an async task to generate the parquet file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| dataset_create_schema | DatasetCreateSchema |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_delete_dataset
Dict[str, Optional[bool]] src_app_api_datasets_delete_dataset(uuid)Delete Dataset Soft delete a dataset by setting is_deleted=True.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_get_dataset
DatasetSchema src_app_api_datasets_get_dataset(uuid)Get Dataset Get a specific dataset by UUID. Generates signed URL for dataset parquet file if available.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_get_dataset_zip_url
DatasetZipUrlSchema src_app_api_datasets_get_dataset_zip_url(uuid)Get Dataset Zip Url Get a signed URL for the dataset zip file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
DatasetZipUrlSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_list_datasets
List[DatasetSchema] src_app_api_datasets_list_datasets()List Datasets List all datasets visible to the current user that are not deleted. Generates signed URLs for dataset parquet files. Query parameters: environment: Optional UUID to filter datasets by environment (filters datasets whose episodes contain twins from that environment).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[DatasetSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_remove_episode_from_dataset
DatasetSchema src_app_api_datasets_remove_episode_from_dataset(uuid, episode_uuid)Remove Episode From Dataset Remove a single episode from a dataset.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| episode_uuid | str |
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_datasets_update_dataset
DatasetSchema src_app_api_datasets_update_dataset(uuid, dataset_update_schema)Update Dataset Update a dataset.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| dataset_update_schema | DatasetUpdateSchema |
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_discover_twins
DiscoveryResponseSchema src_app_api_edge_nodes_discover_twins(edge_register_schema)Discover Twins Discover all twins this edge device should serve. This endpoint auto-registers the edge if it does not exist and returns all twins that contain this edge fingerprint in Twin.metadata[“edge_fingerprint”].
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| edge_register_schema | EdgeRegisterSchema |
Return type
DiscoveryResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_get_edge_twins
List[TwinBindingSchema] src_app_api_edge_nodes_get_edge_twins(uuid)Get Edge Twins Get all twins bound to an edge.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[TwinBindingSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_pair_twin_to_edge
TwinBindingSchema src_app_api_edge_nodes_pair_twin_to_edge(uuid, pair_twin_schema)Pair Twin To Edge Pair a twin to an edge. Pairing is persisted in twin metadata:
- metadata[“edge_fingerprint”] for identity/binding
- metadata[“edge_configs”] for runtime camera config
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| pair_twin_schema | PairTwinSchema |
Return type
TwinBindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_restart_edge_core
EdgeCoreRestartResponseSchema src_app_api_edge_nodes_restart_edge_core(uuid)Restart Edge Core Publish an MQTT restart command for the target edge-core instance.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
EdgeCoreRestartResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_unpair_twin_from_edge
src_app_api_edge_nodes_unpair_twin_from_edge(uuid, twin_uuid)Unpair Twin From Edge Remove a twin binding from an edge.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edge_nodes_update_camera_config
src_app_api_edge_nodes_update_camera_config(uuid, twin_uuid, camera_config_update_schema)Update Camera Config DEPRECATED: camera configs now live in Twin.metadata[“edge_configs”] and must be updated via twin metadata writes.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_uuid | str | ||
| camera_config_update_schema | CameraConfigUpdateSchema |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edges_create_edge
EdgeSchema src_app_api_edges_create_edge(edge_create_schema)Create Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| edge_create_schema | EdgeCreateSchema |
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edges_delete_edge
src_app_api_edges_delete_edge(uuid)Delete Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edges_get_edge
EdgeSchema src_app_api_edges_get_edge(uuid)Get Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edges_get_edges
List[EdgeSchema] src_app_api_edges_get_edges()Get Edges
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[EdgeSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_edges_update_edge
EdgeSchema src_app_api_edges_update_edge(uuid, edge_create_schema)Update Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| edge_create_schema | EdgeCreateSchema |
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_cancel_environment_invitation
Dict[str, object] src_app_api_environments_cancel_environment_invitation(invitation_uuid)Cancel Environment Invitation Cancel a pending invitation
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| invitation_uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_create_environment_for_project
EnvironmentSchema src_app_api_environments_create_environment_for_project(uuid, environment_create_schema)Create Environment For Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| environment_create_schema | EnvironmentCreateSchema |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_create_environment_link
Dict[str, object] src_app_api_environments_create_environment_link(uuid)Create Environment Link Create a shareable link for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_create_environment_simulation
Dict[str, object] src_app_api_environments_create_environment_simulation(uuid, simulation_start_schema=simulation_start_schema)Create Environment Simulation
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| simulation_start_schema | SimulationStartSchema | [optional] |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_create_environment_snapshot
EnvironmentSnapshotSchema src_app_api_environments_create_environment_snapshot(uuid, environment_snapshot_create_schema)Create Environment Snapshot Create a new environment snapshot
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| environment_snapshot_create_schema | EnvironmentSnapshotCreateSchema |
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_add_environment_waypoints
EnvironmentWaypointSchema[] src_app_api_environments_add_environment_waypoints(uuid, environment_waypoint_bulk_create_schema)Add Environment Waypoints Append multiple waypoints to an environment.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| environment_waypoint_bulk_create_schema | EnvironmentWaypointBulkCreateSchema |
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_delete_environment_waypoint
EnvironmentWaypointSchema[] src_app_api_environments_delete_environment_waypoint(uuid, waypoint_id)Delete Environment Waypoint Delete a waypoint from an environment.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| waypoint_id | str |
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_waypoints
EnvironmentWaypointSchema[] src_app_api_environments_get_environment_waypoints(uuid)Get Environment Waypoints List environment waypoints.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_create_standalone_environment
EnvironmentSchema src_app_api_environments_create_standalone_environment(environment_create_schema)Create Standalone Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| environment_create_schema | EnvironmentCreateSchema |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_delete_environment
src_app_api_environments_delete_environment(uuid)Delete Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_delete_environment_for_project
src_app_api_environments_delete_environment_for_project(project_uuid, uuid)Delete Environment For Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| project_uuid | str | ||
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_delete_environment_snapshot
Dict[str, object] src_app_api_environments_delete_environment_snapshot(uuid, snapshot_uuid)Delete Environment Snapshot Delete a snapshot for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| snapshot_uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_delete_recording
Dict[str, object] src_app_api_environments_delete_recording(uuid, recording_uuid)Delete Recording Delete a recording.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| recording_uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_generate_telemetry_recording
RecordingGenerationResponseSchema src_app_api_environments_generate_telemetry_recording(uuid, payload)Generate Telemetry Recording Generate a Parquet recording containing telemetry data for a specific session. Payload should contain:
- twin_uuid: UUID of the twin
- start_timestamp: Start timestamp of the session (microseconds)
- end_timestamp: End timestamp of the session (microseconds)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| payload | Payload |
Return type
RecordingGenerationResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment
EnvironmentSchema src_app_api_environments_get_environment(uuid)Get Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_dirty_twins
List[Dict[str, object]] src_app_api_environments_get_environment_dirty_twins(uuid)Get Environment Dirty Twins List all twins in an environment whose snapshot schema is out of sync with their asset. Compares each twin’s stored snapshot hash against the current asset schema hash. Returns list of dirty twin info with reasons.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[Dict[str, object]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_invitations
Dict[str, object] src_app_api_environments_get_environment_invitations(uuid)Get Environment Invitations Get pending invitations for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_mujoco_scene
src_app_api_environments_get_environment_mujoco_scene(uuid)Get Environment Mujoco Scene Get MuJoCo scene ZIP file for an environment. Returns cached URL if available, otherwise triggers async generation. Cache format (new):
-
Success:
{"url": str, "created_at": str, "task_id": str, "status": "success"} -
Failure:
{"url": None, "created_at": str, "task_id": str, "status": "failed", "error": str} - Legacy: Just the URL string (for backward compatibility)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_mujoco_scene_xml
src_app_api_environments_get_environment_mujoco_scene_xml(uuid)Get Environment Mujoco Scene Xml Get self-contained MuJoCo scene xml for an environment. Composes schema from all twins’ universal_schemas and exports to MuJoCo XML. Note: Mesh file references will be absolute paths to converted files. For a complete scene with assets, use the /mujoco-scene endpoint to get a ZIP.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_mujoco_scene_zip_direct
src_app_api_environments_get_environment_mujoco_scene_zip_direct(uuid)Get Environment Mujoco Scene Zip Direct Get MuJoCo scene ZIP for an environment (direct download). Returns a ZIP file containing:
- mujoco_scene.xml at the root
- assets/: Directory with all required mesh files
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_recordings
Dict[str, object] src_app_api_environments_get_environment_recordings(uuid)Get Environment Recordings Get all available recordings for an environment with pagination. Returns list of recording metadata excluding the recording_path. Query params:
- limit: Max number of records to return (default 50)
- offset: Number of records to skip (default 0)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_sessions
Dict[str, object] src_app_api_environments_get_environment_sessions(uuid)Get Environment Sessions Get all recording sessions for an environment. Returns sessions for all twins in the environment, with start/end timestamps. This is the simplified session-based API that replaces the old twins-sessions endpoint.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_sharing_info_endpoint
Dict[str, object] src_app_api_environments_get_environment_sharing_info_endpoint(uuid)Get Environment Sharing Info Endpoint Get environment sharing and ACL information
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_simulations
Dict[str, object] src_app_api_environments_get_environment_simulations(uuid)Get Environment Simulations
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_snapshot
EnvironmentSnapshotSchema src_app_api_environments_get_environment_snapshot(uuid, snapshot_uuid)Get Environment Snapshot Get a snapshot for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| snapshot_uuid | str |
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_snapshot_hash
Dict[str, Optional[str]] src_app_api_environments_get_environment_snapshot_hash(uuid)Get Environment Snapshot Hash Get the current snapshot hash key for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, Optional[str]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_twins
List[TwinSchema] src_app_api_environments_get_environment_twins(uuid)Get Environment Twins Get twins in an environment with optional dynamic filters. Supports filtering on any field using query parameters with Django lookup syntax. Examples:
- GET
/environments/{uuid}/twins?position_x**gte=0&position_x**lte=10 - GET
/environments/{uuid}/twins?capabilities\_\_locomotion_mode=wheeled - GET
/environments/{uuid}/twins?metadata**power**battery_percent\_\_gte=20 - GET
/environments/{uuid}/twins?metadata**amr**navigation\_\_status=idle - GET
/environments/{uuid}/twins?asset\_\_uuid=xxx - GET
/environments/{uuid}/twins?capabilities**amr**vehicle_type=forklift
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[TwinSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_universal_schema
src_app_api_environments_get_environment_universal_schema(uuid)Get Environment Universal Schema Get universal schema JSON file URL for an environment (cached). Returns cached URL if available, otherwise triggers async generation. Cache format:
- Success:
{"url": str, "created_at": str, "task_id": str, "status": "success"} - Failure:
{"url": None, "created_at": str, "task_id": str, "status": "failed", "error": str}
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_universal_schema_json
src_app_api_environments_get_environment_universal_schema_json(uuid)Get Environment Universal Schema Json Get the universal schema JSON for an environment (direct download). Composes schema from all twins’ universal_schemas. Returns an HTTP attachment with JSON content.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_urdf_bundle
src_app_api_environments_get_environment_urdf_bundle(uuid)Get Environment Urdf Bundle Get environment URDF bundle URL for browser viewer (cached). Returns the URL to the extracted URDF bundle (scene.urdf + assets/) which can be loaded directly by the browser URDF viewer. The bundle is versioned by the environment’s hash_key, so changes to twin schemas will result in a new URL. Returns cached URL if available, otherwise triggers async generation.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_urdf_scene
src_app_api_environments_get_environment_urdf_scene(uuid)Get Environment Urdf Scene Get URDF scene ZIP file URL for an environment (cached). Returns cached URL if available, otherwise triggers async generation. Cache format:
- Success:
{"url": str, "created_at": str, "task_id": str, "status": "success"} - Failure:
{"url": None, "created_at": str, "task_id": str, "status": "failed", "error": str}
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_environment_urdf_scene_zip_direct
src_app_api_environments_get_environment_urdf_scene_zip_direct(uuid)Get Environment Urdf Scene Zip Direct Get URDF scene ZIP for an environment (direct download). Returns a ZIP file containing:
- scene.urdf: The complete URDF scene
- assets/: Directory with all required mesh files
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_my_environment_permissions
PermissionsSchema src_app_api_environments_get_my_environment_permissions(uuid)Get My Environment Permissions Get current user’s permissions on this environment.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
PermissionsSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_get_recording_data
Dict[str, object] src_app_api_environments_get_recording_data(uuid, recording_uuid, sample_rate_hz=sample_rate_hz)Get Recording Data Get sampled recording data for visualization. Returns timestamps and observation states sampled at the specified rate.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| recording_uuid | str | ||
| sample_rate_hz | int | [optional] [default to 10] |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_import_environment_mujoco_scene
ImportResultSchema src_app_api_environments_import_environment_mujoco_scene(uuid, file, replace_existing=replace_existing)Import Environment Mujoco Scene Import twins into an environment from a MuJoCo scene file. Accepts either:
- A .xml file (raw MJCF scene)
- A .zip file containing mujoco_scene.xml at the root
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray | ||
| replace_existing | bool | [optional] [default to False] |
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_import_environment_universal_schema
ImportResultSchema src_app_api_environments_import_environment_universal_schema(uuid, file, replace_existing=replace_existing)Import Environment Universal Schema Import twins into an environment from a Cyberwave universal schema JSON file. The JSON must contain an extensions.cyberwave.twins registry (i.e. it must have been exported by Cyberwave via GET
/{uuid}/universal-schema.json).
Multipart form field: file (.json)
Query param: replace_existing (bool, default false)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray | ||
| replace_existing | bool | [optional] [default to False] |
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_import_environment_urdf
ImportResultSchema src_app_api_environments_import_environment_urdf(uuid, file, replace_existing=replace_existing, asset_uuid=asset_uuid, asset_registry_id=asset_registry_id, position_x=position_x, position_y=position_y, position_z=position_z, rotation_x=rotation_x, rotation_y=rotation_y, rotation_z=rotation_z, rotation_w=rotation_w)Import Environment Urdf Import a single robot twin into an environment from a URDF file. The URDF describes one robot; you must identify the matching Cyberwave Asset via asset_uuid or asset_registry_id so the twin can be linked correctly. Multipart form field: file (.urdf) Query params: asset_uuid / asset_registry_id - required: identifies the Cyberwave Asset position_x/y/z - world position for the spawned twin (default 0,0,0) rotation_x/y/z/w - world orientation quaternion (default identity) replace_existing - if true, delete existing twins first
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray | ||
| replace_existing | bool | [optional] [default to False] | |
| asset_uuid | str | [optional] | |
| asset_registry_id | str | [optional] | |
| position_x | float | [optional] [default to 0.0] | |
| position_y | float | [optional] [default to 0.0] | |
| position_z | float | [optional] [default to 0.0] | |
| rotation_x | float | [optional] [default to 0.0] | |
| rotation_y | float | [optional] [default to 0.0] | |
| rotation_z | float | [optional] [default to 0.0] | |
| rotation_w | float | [optional] [default to 1.0] |
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_invite_user_to_environment
Dict[str, object] src_app_api_environments_invite_user_to_environment(uuid)Invite User To Environment Invite a non-existent user to an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_list_all_environments
List[EnvironmentSchema] src_app_api_environments_list_all_environments()List All Environments
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[EnvironmentSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_list_environment_mission_executions
List[MissionExecutionSchema] src_app_api_environments_list_environment_mission_executions(uuid, status=status, twin_uuid=twin_uuid, limit=limit)List Environment Mission Executions List mission executions for all twins in an environment. Args: uuid: Environment UUID status: Filter by status (pending, running, paused, completed, failed, cancelled) twin_uuid: Filter by specific twin UUID limit: Maximum number of results (default 100) Returns: List of mission executions ordered by created_at (newest first)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| status | str | [optional] | |
| twin_uuid | str | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
List[MissionExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_list_environment_snapshots
List[EnvironmentSnapshotSchema] src_app_api_environments_list_environment_snapshots(uuid)List Environment Snapshots List all snapshots for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[EnvironmentSnapshotSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_list_environment_task_executions
List[TaskExecutionSchema] src_app_api_environments_list_environment_task_executions(uuid, status=status, twin_uuid=twin_uuid, limit=limit)List Environment Task Executions List task executions for all twins in an environment. Args: uuid: Environment UUID status: Filter by status (pending, running, completed, failed, cancelled) twin_uuid: Filter by specific twin UUID limit: Maximum number of results (default 100) Returns: List of task executions ordered by created_at (newest first)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| status | str | [optional] | |
| twin_uuid | str | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
List[TaskExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_list_environments_for_project
List[EnvironmentSchema] src_app_api_environments_list_environments_for_project(uuid)List Environments For Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[EnvironmentSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_process_all_environment_sessions
Dict[str, object] src_app_api_environments_process_all_environment_sessions(uuid)Process All Environment Sessions Process all recording sessions for all twins in the environment. This endpoint will:
- Discover all twins in the environment
- Find all sessions for each twin
- Queue recording generation tasks for each session
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_remove_user_from_environment
Dict[str, object] src_app_api_environments_remove_user_from_environment(uuid, user_id)Remove User From Environment Remove user access from environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| user_id | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_reset_environment
Dict[str, object] src_app_api_environments_reset_environment(uuid)Reset Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_restore_environment_snapshot
EnvironmentSchema src_app_api_environments_restore_environment_snapshot(uuid, snapshot_uuid)Restore Environment Snapshot Restore a snapshot for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| snapshot_uuid | str |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_revoke_environment_link
Dict[str, object] src_app_api_environments_revoke_environment_link(uuid)Revoke Environment Link Revoke a shareable link for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_share_environment_with_user
Dict[str, object] src_app_api_environments_share_environment_with_user(uuid)Share Environment With User Share environment with a user by email
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_stop_environment_simulation
Dict[str, object] src_app_api_environments_stop_environment_simulation(uuid, simulation_id)Stop Environment Simulation
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| simulation_id | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_update_environment
EnvironmentSchema src_app_api_environments_update_environment(uuid, environment_create_schema)Update Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| environment_create_schema | EnvironmentCreateSchema |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_update_environment_for_project
EnvironmentSchema src_app_api_environments_update_environment_for_project(project_uuid, uuid, environment_create_schema)Update Environment For Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| project_uuid | str | ||
| uuid | str | ||
| environment_create_schema | EnvironmentCreateSchema |
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_update_environment_snapshot
EnvironmentSnapshotSchema src_app_api_environments_update_environment_snapshot(uuid, snapshot_uuid)Update Environment Snapshot Update a snapshot for an environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| snapshot_uuid | str |
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_environments_update_recording_metadata
TwinTelemetryMetadataSchema src_app_api_environments_update_recording_metadata(uuid, recording_uuid, update_recording_metadata_schema)Update Recording Metadata Update recording metadata (e.g., session name).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| recording_uuid | str | ||
| update_recording_metadata_schema | UpdateRecordingMetadataSchema |
Return type
TwinTelemetryMetadataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_create_episode
EpisodeSchema src_app_api_episode_create_episode(episode_create_schema)Create Episode Create a new episode. Timestamps in microseconds.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| episode_create_schema | EpisodeCreateSchema |
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_delete_episode
Dict[str, Optional[bool]] src_app_api_episode_delete_episode(uuid)Delete Episode Delete an episode.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_get_episode
EpisodeSchema src_app_api_episode_get_episode(uuid)Get Episode Get a specific episode by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_list_episode_task_names
List[Optional[str]] src_app_api_episode_list_episode_task_names()List Episode Task Names List distinct task names for episodes in the given environment (for autocomplete suggestions).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[Optional[str]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_list_episodes
List[EpisodeSchema] src_app_api_episode_list_episodes()List Episodes List all episodes visible to the current user.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[EpisodeSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_episode_update_episode
EpisodeSchema src_app_api_episode_update_episode(uuid, episode_update_schema)Update Episode Update an episode.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| episode_update_schema | EpisodeUpdateSchema |
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_events_create_business_event
BusinessEventSchema src_app_api_events_create_business_event(business_event_create_schema)Create Business Event Create a business event and trigger matching workflows. Sources: sensor, robot, edge_node, workflow, user, system For ML model events, use source=‘edge_node’ or ‘system’ and include model details in the data field:
{"model": "yolo-v8", "version": "1.0", ...}
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| business_event_create_schema | BusinessEventCreateSchema |
Return type
BusinessEventSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_events_list_live_events
BusinessEventListResponseSchema src_app_api_events_list_live_events(environment_uuid=environment_uuid, source=source, severity=severity, event_type=event_type, last_timestamp_ms=last_timestamp_ms, limit=limit)List Live Events Get recent business events for live visualization. Supports filtering by:
- environment_uuid: Filter by environment
- source: Filter by source type (sensor, robot, edge_node, workflow, user, system)
- severity: Filter by severity level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
- event_type: Filter by event type (exact match)
- last_timestamp_ms: Get events after this timestamp (for polling)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| environment_uuid | str | [optional] | |
| source | str | [optional] | |
| severity | str | [optional] | |
| event_type | str | [optional] | |
| last_timestamp_ms | int | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
BusinessEventListResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_executions_get_task_execution
DeferredTaskExecutionResponseSchema src_app_api_executions_get_task_execution(uuid, workspace_uuid)Get Task Execution Get a specific execution by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workspace_uuid | str |
Return type
DeferredTaskExecutionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_executions_list_task_executions
List[DeferredTaskExecutionResponseSchema] src_app_api_executions_list_task_executions(workspace_uuid)List Task Executions List all executions for a workspace.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workspace_uuid | str |
Return type
List[DeferredTaskExecutionResponseSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_invitation_router_accept_invitation_endpoint
Dict[str, object] src_app_api_invitation_router_accept_invitation_endpoint(token)Accept Invitation Endpoint Accept a user invitation via token
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| token | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_invitation_router_get_invitation_info
Dict[str, object] src_app_api_invitation_router_get_invitation_info(token)Get Invitation Info Get invitation info without accepting it
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| token | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_keybindings_create_keybinding
KeybindingSchema src_app_api_keybindings_create_keybinding(keybinding_create_schema)Create Keybinding Create a new keybinding.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| keybinding_create_schema | KeybindingCreateSchema |
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_keybindings_delete_keybinding
src_app_api_keybindings_delete_keybinding(uuid)Delete Keybinding Delete a keybinding.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_keybindings_get_keybinding
KeybindingSchema src_app_api_keybindings_get_keybinding(uuid)Get Keybinding Get a specific keybinding by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_keybindings_list_keybindings
List[KeybindingSchema] src_app_api_keybindings_list_keybindings()List Keybindings List all keybindings for the authenticated user.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[KeybindingSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_keybindings_update_keybinding
KeybindingSchema src_app_api_keybindings_update_keybinding(uuid, keybinding_update_schema)Update Keybinding Update an existing keybinding.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| keybinding_update_schema | KeybindingUpdateSchema |
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_labs_admin_force_end_session
EndSessionResponseSchema src_app_api_labs_admin_force_end_session(session_uuid)Admin Force End Session Staff-only: force-end any session or remove a user from the queue.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| session_uuid | str |
Return type
EndSessionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_labs_end_milan_lab_session
EndSessionResponseSchema src_app_api_labs_end_milan_lab_session()End Milan Lab Session End the user’s active session or cancel their queue entry. If the user had an active session the next queued user is automatically promoted to active.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
EndSessionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_labs_get_admin_lab_overview
AdminLabOverviewSchema src_app_api_labs_get_admin_lab_overview()Get Admin Lab Overview Staff-only: overview of active session, queue, and recent history.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
AdminLabOverviewSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_labs_get_milan_lab_status
LabStatusResponseSchema src_app_api_labs_get_milan_lab_status()Get Milan Lab Status Get current status of the Milan SO101 lab for the requesting user. Returns whether the lab is free or in use, the user’s session state (active / queued / none), queue position, and estimated wait time.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
LabStatusResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_labs_request_milan_lab_access
LabAccessResponseSchema src_app_api_labs_request_milan_lab_access(body)Request Milan Lab Access Request access to the Milan SO101 lab.
- If the lab is free the user gets immediate access (10-min session).
- If the lab is in use the user is added to the queue.
- Idempotent: calling again while active/queued returns the existing session.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| body | object |
Return type
LabAccessResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_create_map
MapDataSchema src_app_api_maps_create_map(map_type, twin_uuid=twin_uuid, environment_uuid=environment_uuid, resolution=resolution, origin_x=origin_x, origin_y=origin_y, origin_z=origin_z, origin_roll=origin_roll, origin_pitch=origin_pitch, origin_yaw=origin_yaw, metadata=metadata, file=file)Create Map Create/upload a new map.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| map_type | str | ||
| twin_uuid | str | [optional] | |
| environment_uuid | str | [optional] | |
| resolution | float | [optional] | |
| origin_x | float | [optional] [default to 0.0] | |
| origin_y | float | [optional] [default to 0.0] | |
| origin_z | float | [optional] [default to 0.0] | |
| origin_roll | float | [optional] [default to 0.0] | |
| origin_pitch | float | [optional] [default to 0.0] | |
| origin_yaw | float | [optional] [default to 0.0] | |
| metadata | Metadata | [optional] | |
| file | bytearray | [optional] |
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_delete_map
src_app_api_maps_delete_map(uuid)Delete Map Delete a map.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_download_map_data
src_app_api_maps_download_map_data(uuid)Download Map Data Download map data file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_finalize_stream_map
MapDataSchema src_app_api_maps_finalize_stream_map(uuid, resolution=resolution, origin_x=origin_x, origin_y=origin_y, origin_z=origin_z, origin_roll=origin_roll, origin_pitch=origin_pitch, origin_yaw=origin_yaw, metadata=metadata, file=file)Finalize Stream Map Finalize a stream-started map by uploading the real map file.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| resolution | float | [optional] | |
| origin_x | float | [optional] | |
| origin_y | float | [optional] | |
| origin_z | float | [optional] | |
| origin_roll | float | [optional] | |
| origin_pitch | float | [optional] | |
| origin_yaw | float | [optional] | |
| metadata | Metadata | [optional] | |
| file | bytearray | [optional] |
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_get_map
MapDataSchema src_app_api_maps_get_map(uuid)Get Map Get map metadata by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_get_map_image
src_app_api_maps_get_map_image(uuid)Get Map Image Return the map data file converted to PNG (supports PGM, PBM, PPM, etc.).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_list_environment_maps
List[MapDataSchema] src_app_api_maps_list_environment_maps(uuid)List Environment Maps List all maps in an environment (including maps from twins in that environment).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[MapDataSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_list_maps
List[MapDataSchema] src_app_api_maps_list_maps()List Maps List all maps accessible to the user.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[MapDataSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_list_twin_maps
List[MapDataSchema] src_app_api_maps_list_twin_maps(uuid)List Twin Maps List maps for a specific twin.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[MapDataSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_start_map_from_stream
MapDataSchema src_app_api_maps_start_map_from_stream(map_stream_start_schema)Start Map From Stream Create a map entry to receive updates from a live stream.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| map_stream_start_schema | MapStreamStartSchema |
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_maps_stop_map_from_stream
MapDataSchema src_app_api_maps_stop_map_from_stream(map_stream_stop_schema)Stop Map From Stream Queue a stop/finalize request for the active streaming map.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| map_stream_stop_schema | MapStreamStopSchema |
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_cancel_mission_execution
src_app_api_missions_cancel_mission_execution(twin_uuid, mission_uuid, uuid)Cancel Mission Execution Cancel a mission execution.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| mission_uuid | str | ||
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_create_mission
MissionSchema src_app_api_missions_create_mission(uuid, create_mission_schema)Create Mission Create a mission definition (sequential task list).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| create_mission_schema | CreateMissionSchema |
Return type
MissionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_delete_mission
src_app_api_missions_delete_mission(twin_uuid, uuid)Delete Mission Delete a mission definition.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_execute_mission
MissionExecutionSchema src_app_api_missions_execute_mission(twin_uuid, uuid, create_mission_execution_schema)Execute Mission Execute a mission (create a mission execution).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| uuid | str | ||
| create_mission_execution_schema | CreateMissionExecutionSchema |
Return type
MissionExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_get_mission
MissionSchema src_app_api_missions_get_mission(twin_uuid, uuid)Get Mission Get a mission definition by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| uuid | str |
Return type
MissionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_get_mission_execution
MissionExecutionSchema src_app_api_missions_get_mission_execution(twin_uuid, mission_uuid, uuid)Get Mission Execution Get a mission execution by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| mission_uuid | str | ||
| uuid | str |
Return type
MissionExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_list_mission_executions
List[MissionExecutionSchema] src_app_api_missions_list_mission_executions(twin_uuid, uuid, status=status, limit=limit)List Mission Executions List executions for a mission definition.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str | ||
| uuid | str | ||
| status | str | [optional] | |
| limit | int | [optional] [default to 50] |
Return type
List[MissionExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_missions_list_missions
List[MissionSchema] src_app_api_missions_list_missions(uuid)List Missions List mission definitions for a twin.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[MissionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_create_mlmodel
MLModelSchema src_app_api_mlmodels_create_mlmodel(ml_model_create_schema)Create Mlmodel Create a new ML model.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ml_model_create_schema | MLModelCreateSchema |
Return type
MLModelSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_delete_mlmodel
src_app_api_mlmodels_delete_mlmodel(uuid)Delete Mlmodel Delete an ML model.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_get_mlmodel
MLModelSchema src_app_api_mlmodels_get_mlmodel(uuid)Get Mlmodel Get a specific ML model by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
MLModelSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_get_mlmodel_weights
Dict[str, Optional[str]] src_app_api_mlmodels_get_mlmodel_weights(uuid)Get Mlmodel Weights Get a signed URL for downloading the ML model checkpoint weights. The checkpoint is expected to be a tar archive containing the model files (config.json, adapter files, etc.) from training. Returns: Dict with signed_url and expires_at fields
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, Optional[str]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_list_mlmodels
List[MLModelSchema] src_app_api_mlmodels_list_mlmodels(deployment=deployment, edge_compatible=edge_compatible)List Mlmodels List all ML models for the authenticated user’s workspace. Query params: deployment: Filter by deployment type (cloud, edge, hybrid) edge_compatible: If true, return only edge or hybrid models
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| deployment | str | [optional] | |
| edge_compatible | bool | [optional] |
Return type
List[MLModelSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mlmodels_update_mlmodel
MLModelSchema src_app_api_mlmodels_update_mlmodel(uuid, ml_model_update_schema)Update Mlmodel Update an existing ML model.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| ml_model_update_schema | MLModelUpdateSchema |
Return type
MLModelSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_create_mltraining
Response src_app_api_mltrainings_create_mltraining(ml_training_create_schema)Create Mltraining Create a new ML training.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ml_training_create_schema | MLTrainingCreateSchema |
Return type
ResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_delete_mltraining
Dict[str, object] src_app_api_mltrainings_delete_mltraining(uuid)Delete Mltraining Delete an ML training.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_deploy_mltraining
Dict[str, object] src_app_api_mltrainings_deploy_mltraining(uuid, ml_training_deploy_schema)Deploy Mltraining Deploy a completed ML training to one or more twins. The deployment process:
- Export the trained model weights
- Create a new ControllerPolicy (type: mlmodel) with the trained model
- Assign the controller policy to the specified twins
- Export trained model weights to storage
- Create ControllerPolicy with type=‘mlmodel’ and model reference
- Update each twin’s controller_policy FK to the new policy
- Optionally start inference service
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| ml_training_deploy_schema | MLTrainingDeploySchema |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_get_deployed_mltrainings
List[MLTrainingSchema] src_app_api_mltrainings_get_deployed_mltrainings()Get Deployed Mltrainings Get all deployed ML trainings for the authenticated user’s workspaces.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[MLTrainingSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_get_mltraining
MLTrainingSchema src_app_api_mltrainings_get_mltraining(uuid)Get Mltraining Get a specific ML training by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
MLTrainingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_list_mltrainings_for_user_workspaces
List[MLTrainingSchema] src_app_api_mltrainings_list_mltrainings_for_user_workspaces()List Mltrainings For User Workspaces List all ML trainings for the authenticated user’s workspaces.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[MLTrainingSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_mltrainings_update_mltraining
MLTrainingSchema src_app_api_mltrainings_update_mltraining(uuid, ml_training_update_schema)Update Mltraining Update an ML training.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| ml_training_update_schema | MLTrainingUpdateSchema |
Return type
MLTrainingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_navigation_execute_twin_navigation
TwinActionResponseSchema src_app_api_navigation_execute_twin_navigation(uuid, twin_navigation_command_schema)Execute Twin Navigation
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_navigation_command_schema | TwinNavigationCommandSchema |
Return type
TwinActionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_create_project
ProjectSchema src_app_api_projects_create_project(project_create_schema)Create Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| project_create_schema | ProjectCreateSchema |
Return type
ProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_create_project_link
src_app_api_projects_create_project_link(uuid, link_share_create_schema)Create Project Link Create a shareable link for a project.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| link_share_create_schema | LinkShareCreateSchema |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_delete_project
src_app_api_projects_delete_project(uuid)Delete Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_get_my_project_permissions
PermissionsSchema src_app_api_projects_get_my_project_permissions(uuid)Get My Project Permissions Get current user’s permissions on this project.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
PermissionsSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_get_project
ProjectSchema src_app_api_projects_get_project(uuid)Get Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
ProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_get_project_shares
SharesResponseSchema src_app_api_projects_get_project_shares(uuid)Get Project Shares List all shares for a project.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
SharesResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_invite_user_to_project
Dict[str, object] src_app_api_projects_invite_user_to_project(uuid)Invite User To Project Invite a non-existent user to a project.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_list_projects
List[ProjectSchema] src_app_api_projects_list_projects()List Projects List all projects visible to the current user.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[ProjectSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_revoke_project_link
src_app_api_projects_revoke_project_link(uuid, link_share_revoke_schema)Revoke Project Link Revoke a shareable link.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| link_share_revoke_schema | LinkShareRevokeSchema |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_share_project
ProjectShareResponseSchema src_app_api_projects_share_project(uuid, share_schema)Share Project Share a project with a user or team.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| share_schema | ShareSchema |
Return type
ProjectShareResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_unshare_project
ProjectShareResponseSchema src_app_api_projects_unshare_project(uuid, share_schema)Unshare Project Remove sharing permissions for a user or team.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| share_schema | ShareSchema |
Return type
ProjectShareResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_projects_update_project
ProjectSchema src_app_api_projects_update_project(uuid, project_create_schema)Update Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| project_create_schema | ProjectCreateSchema |
Return type
ProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tagged_frames_create_tagged_frames
TaggedFramesSchema src_app_api_tagged_frames_create_tagged_frames(tagged_frames_create_schema)Create Tagged Frames Create a new tagged frames entry.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| tagged_frames_create_schema | TaggedFramesCreateSchema |
Return type
TaggedFramesSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tagged_frames_delete_tagged_frames
src_app_api_tagged_frames_delete_tagged_frames(uuid)Delete Tagged Frames Delete a tagged frames entry by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tagged_frames_get_tagged_frames
TaggedFramesSchema src_app_api_tagged_frames_get_tagged_frames(uuid)Get Tagged Frames Get a specific tagged frames by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
TaggedFramesSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tagged_frames_list_tagged_frames
List[TaggedFramesSchema] src_app_api_tagged_frames_list_tagged_frames(recording_uuid=recording_uuid)List Tagged Frames List all tagged frames accessible by the user. Optionally filter by recording_uuid.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| recording_uuid | str | [optional] |
Return type
List[TaggedFramesSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tagged_frames_update_tagged_frames
TaggedFramesSchema src_app_api_tagged_frames_update_tagged_frames(uuid, tagged_frames_update_schema)Update Tagged Frames Update an existing tagged frames entry.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| tagged_frames_update_schema | TaggedFramesUpdateSchema |
Return type
TaggedFramesSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_cancel_task_execution
src_app_api_tasks_cancel_task_execution(uuid)Cancel Task Execution Cancel a task execution.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_create_task
TaskSchema src_app_api_tasks_create_task(create_task_schema)Create Task Create a reusable task definition.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| create_task_schema | CreateTaskSchema |
Return type
TaskSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_delete_task
src_app_api_tasks_delete_task(uuid)Delete Task Delete a task.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_execute_task
TaskExecutionSchema src_app_api_tasks_execute_task(uuid, execute_task_schema)Execute Task Execute a task on a twin (standalone, not part of mission).
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| execute_task_schema | ExecuteTaskSchema |
Return type
TaskExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_get_task
TaskSchema src_app_api_tasks_get_task(uuid)Get Task Get a task by UUID.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
TaskSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_get_task_execution
TaskExecutionSchema src_app_api_tasks_get_task_execution(uuid)Get Task Execution
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
TaskExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_list_task_queue
List[TaskExecutionSchema] src_app_api_tasks_list_task_queue(status=status, environment_uuid=environment_uuid, twin_uuid=twin_uuid, task_type=task_type, limit=limit)List Task Queue List task executions (the order queue). Filters:
- status: Filter by status (pending, queued, running, completed, failed, cancelled) Can be comma-separated for multiple: “pending,queued,running”
- environment_uuid: Filter by environment
- twin_uuid: Filter by specific twin
- task_type: Filter by task type (navigation, motion, mlmodel)
- limit: Max results (default 100)
- GET /tasks/queue?status=pending,queued,running (active queue)
- GET /tasks/queue?status=running (currently executing)
- GET /tasks/queue?environment_uuid=xxx&status=pending
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| status | str | [optional] | |
| environment_uuid | str | [optional] | |
| twin_uuid | str | [optional] | |
| task_type | str | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
List[TaskExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_list_tasks
List[TaskSchema] src_app_api_tasks_list_tasks(workspace_uuid=workspace_uuid, task_type=task_type)List Tasks List tasks in workspace.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workspace_uuid | str | [optional] | |
| task_type | str | [optional] |
Return type
List[TaskSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_tasks_update_task
TaskSchema src_app_api_tasks_update_task(uuid, update_task_schema)Update Task Update a task.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| update_task_schema | UpdateTaskSchema |
Return type
TaskSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_create_twin
TwinSchema src_app_api_twins_create_twin(twin_create_schema)Create Twin
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_create_schema | TwinCreateSchema |
Return type
TwinSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_delete_twin
src_app_api_twins_delete_twin(uuid)Delete Twin
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_execute_twin_action
TwinActionResponseSchema src_app_api_twins_execute_twin_action(uuid, twin_action_request_schema)Execute Twin Action
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_action_request_schema | TwinActionRequestSchema |
Return type
TwinActionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_recording
TwinConnectionEventSchema src_app_api_twins_get_recording(recording_uuid)Get Recording Get a specific recording by UUID. Returns TWIN_RECORDING_INFO event with full metadata. Includes signed_url for mp4_path if available.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| recording_uuid | str |
Return type
TwinConnectionEventSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin
TwinSchema src_app_api_twins_get_twin(uuid)Get Twin
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
TwinSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_action_status
TwinActionStatusSchema src_app_api_twins_get_twin_action_status(uuid, action_id)Get Twin Action Status
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| action_id | str |
Return type
TwinActionStatusSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_calibration
TwinJointCalibrationSchema src_app_api_twins_get_twin_calibration(uuid)Get Twin Calibration
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
TwinJointCalibrationSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_connection_history
List[TwinConnectionEventSchema] src_app_api_twins_get_twin_connection_history(uuid, limit=limit)Get Twin Connection History Get the connection history for a twin. Returns recent telemetry events like connected, disconnected, telemetry_start, telemetry_end.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| limit | int | [optional] [default to 20] |
Return type
List[TwinConnectionEventSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_driver_logs
TwinDriverLogsResponseSchema src_app_api_twins_get_twin_driver_logs(uuid, limit=limit, offset=offset)Get Twin Driver Logs Get persisted driver logs for a twin, newest-first. Query params:
- limit: max rows to return (default 100, max 500)
- offset: number of rows to skip (default 0)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| limit | int | [optional] [default to 100] | |
| offset | int | [optional] [default to 0] |
Return type
TwinDriverLogsResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_latest_frame
src_app_api_twins_get_twin_latest_frame(uuid, mock=mock)Get Twin Latest Frame Get the latest frame from a twin’s camera stream. Serves the frame directly from Redis without saving to permanent storage. For multi-camera twins, the media service stores frames with key
frame:{twin*uuid}*{sensor_id}:rgb:latest. Pass ?sensor_id=wrist_camera to get a specific camera.
Query params:
- mock: if true, return a deterministic mock JPEG payload.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| mock | bool | [optional] [default to False] |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_latest_metrics
src_app_api_twins_get_twin_latest_metrics(uuid)Get Twin Latest Metrics Get the latest metrics snapshot for a twin. Returns the most recent metrics from Twin.metadata (current state) plus the timestamp of the last update. This is more efficient than querying historical data when you only need the current state.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_links
List[Optional[str]] src_app_api_twins_get_twin_links(uuid)Get Twin Links Get list of available links in a twin’s schema for docking. Returns a list of link names that can be used as attachment points when docking other twins to this twin.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[Optional[str]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_metrics
List[TwinMetricsQuerySchema] src_app_api_twins_get_twin_metrics(uuid, start=start, end=end, limit=limit)Get Twin Metrics Get historical metrics for a twin. Returns time-series metrics data (battery level, navigation status, etc.) logged via MQTT from edge devices. Args: uuid: Twin UUID start: Start datetime (ISO format, e.g., “2026-01-01T00:00:00Z”) end: End datetime (ISO format) limit: Max results (default 100, max 1000) Returns: List of metrics snapshots ordered by timestamp (newest first) Examples: GET
/twins/{uuid}/metrics
GET /twins/{uuid}/metrics?start=2026-01-20T00:00:00Z&limit=500
GET /twins/{uuid}/metrics?start=2026-01-01&end=2026-01-21
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| start | str | [optional] | |
| end | str | [optional] | |
| limit | int | [optional] [default to 100] |
Return type
List[TwinMetricsQuerySchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_motions
TwinMotionResponseSchema src_app_api_twins_get_twin_motions(uuid, environment_uuid=environment_uuid)Get Twin Motions
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| environment_uuid | str | [optional] |
Return type
TwinMotionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_notebook
src_app_api_twins_get_twin_notebook(uuid)Get Twin Notebook Generate and serve a Jupyter notebook for this twin. This endpoint is public so Google Colab can fetch it directly. Usage:
https://colab.research.google.com/#fileId=<api_url>/twins/{uuid}/notebook.ipynb
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_recordings
List[TwinConnectionEventSchema] src_app_api_twins_get_twin_recordings(uuid)Get Twin Recordings Get all recordings for a twin. Returns TWIN_RECORDING_INFO events (parquet recordings) for camera twins. Only returns recordings that have mp4_path (camera recordings). Includes signed_url in metadata for each recording.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[TwinConnectionEventSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_relationships
List[TwinRelationshipSchema] src_app_api_twins_get_twin_relationships(uuid)Get Twin Relationships MVP: Generate mock relationships based on twin names and environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[TwinRelationshipSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_get_twin_universal_schema_at_path
Dict[str, object] src_app_api_twins_get_twin_universal_schema_at_path(uuid, path=path)Get Twin Universal Schema At Path Get value at a specific JSON Pointer path in the twin’s universal schema. Query params: path: JSON Pointer path (e.g., /sensors/0, /extensions/cyberwave/capabilities) Returns:
{"path": "...", "value": <any json>}
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| path | str | [optional] [default to ”] |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_link_occupancy_map
src_app_api_twins_link_occupancy_map(uuid, occupancy_map_create_schema)Link Occupancy Map Link an occupancy-grid map to this twin, compute (or retrieve) the world->map transform, and send it to the edge via MQTT. The map must have been uploaded beforehand via
POST /maps
(with map_type=occupancy_grid).
Flow:
- Validate and associate the map with the twin.
- If the environment already has a manually-set navigation transform, use it. Otherwise, attempt to auto-align the SLAM map with the 3D scene (currently mocked as identity).
- Save the transform into
environment.settings.navigation. - Publish the transform on the
occupancy-map-tfMQTT topic so the edge waypoint bridge sets itsworld -> mapTF.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| occupancy_map_create_schema | OccupancyMapCreateSchema |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_list_all_twins
List[TwinSchema] src_app_api_twins_list_all_twins()List All Twins
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[TwinSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_patch_twin_universal_schema
Dict[str, object] src_app_api_twins_patch_twin_universal_schema(uuid, twin_universal_schema_patch_schema)Patch Twin Universal Schema Update the twin’s universal schema using JSON Pointer operations. This allows editing twin-specific schema overrides, such as:
- /sensors (array of sensor objects)
- /extensions/cyberwave/capabilities
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_universal_schema_patch_schema | TwinUniversalSchemaPatchSchema |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_reload_twin_capabilities
Dict[str, object] src_app_api_twins_reload_twin_capabilities(uuid)Reload Twin Capabilities Get capabilities from Twin.universal_schema. Note: Capabilities are now derived from schema only, not cached in DB. This endpoint is kept for backward compatibility. Returns:
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_reload_twins_capabilities_bulk
Dict[str, object] src_app_api_twins_reload_twins_capabilities_bulk(reload_capabilities_bulk_schema)Reload Twins Capabilities Bulk Bulk reload capabilities for multiple twins. Filters:
- environment_uuid: Reload all twins in an environment
- twin_uuids: Reload specific twins by UUID
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| reload_capabilities_bulk_schema | ReloadCapabilitiesBulkSchema |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_sync_twin_with_asset
SyncWithAssetSchema src_app_api_twins_sync_twin_with_asset(uuid)Sync Twin With Asset Sync twin metadata and universal_schema with its parent asset. This updates the twin’s metadata with the latest values from the asset for fields that are typically defined at the asset level (like locomotion_animations). Fields that are twin-specific (like controller assignments) are preserved. Note: This also re-snapshots the twin’s universal_schema from the asset, overwriting any twin-specific schema edits made via PATCH
/api/v1/twins/{uuid}/universal-schema.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
SyncWithAssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_update_twin
TwinSchema src_app_api_twins_update_twin(uuid, twin_create_schema)Update Twin Update a twin’s properties. Note: When changing the asset_uuid, the twin’s universal_schema will be re-snapshotted from the new asset, overwriting any twin-specific schema edits made via PATCH
/api/v1/twins/{uuid}/universal-schema.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_create_schema | TwinCreateSchema |
Return type
TwinSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_update_twin_calibration
TwinJointCalibrationSchema src_app_api_twins_update_twin_calibration(uuid, twin_joint_calibration_schema)Update Twin Calibration
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_joint_calibration_schema | TwinJointCalibrationSchema |
Return type
TwinJointCalibrationSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_twins_update_twin_state
TwinSchema src_app_api_twins_update_twin_state(uuid, twin_state_update_schema)Update Twin State
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| twin_state_update_schema | TwinStateUpdateSchema |
Return type
TwinSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_create_urdf_project
URDFProjectSchema src_app_api_urdf_create_urdf_project(urdf_project_create_schema)Create Urdf Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| urdf_project_create_schema | URDFProjectCreateSchema |
Return type
URDFProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_delete_urdf_project
src_app_api_urdf_delete_urdf_project(uuid)Delete Urdf Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_fix_urdf_project_slug
URDFProjectSchema src_app_api_urdf_fix_urdf_project_slug(uuid, new_slug, new_main_file_path)Fix Urdf Project Slug Fix a URDF project’s slug and main_file_path to match actual storage. This is useful when files exist in storage but the DB record points to the wrong location. Requires staff/superuser permissions.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| new_slug | str | ||
| new_main_file_path | str |
Return type
URDFProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_twin_joint_state
JointStateSchema src_app_api_urdf_get_twin_joint_state(uuid, joint_name)Get Twin Joint State
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| joint_name | str |
Return type
JointStateSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_twin_joint_states
JointStatesSchema src_app_api_urdf_get_twin_joint_states(uuid)Get Twin Joint States
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
JointStatesSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_twin_joints
List[JointSchema] src_app_api_urdf_get_twin_joints(uuid)Get Twin Joints
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[JointSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_twin_robot_description
RobotDescriptionSchema src_app_api_urdf_get_twin_robot_description(uuid)Get Twin Robot Description
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
RobotDescriptionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_twin_urdf_raw
str src_app_api_urdf_get_twin_urdf_raw(uuid)Get Twin Urdf Raw
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
strAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_get_urdf_project
URDFProjectSchema src_app_api_urdf_get_urdf_project(uuid)Get Urdf Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
URDFProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_list_urdf_projects
List[URDFProjectSchema] src_app_api_urdf_list_urdf_projects()List Urdf Projects
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[URDFProjectSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_update_twin_joint_state
JointStateSchema src_app_api_urdf_update_twin_joint_state(uuid, joint_name, joint_state_update_schema)Update Twin Joint State
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| joint_name | str | ||
| joint_state_update_schema | JointStateUpdateSchema |
Return type
JointStateSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_update_twin_joint_states
JointStatesSchema src_app_api_urdf_update_twin_joint_states(uuid, bulk_joint_states_update_schema)Update Twin Joint States
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| bulk_joint_states_update_schema | BulkJointStatesUpdateSchema |
Return type
JointStatesSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_update_urdf_project
URDFProjectSchema src_app_api_urdf_update_urdf_project(uuid, urdf_project_create_schema)Update Urdf Project
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| urdf_project_create_schema | URDFProjectCreateSchema |
Return type
URDFProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_urdf_upload_zip_file
URDFProjectSchema src_app_api_urdf_upload_zip_file(uuid, file)Upload Zip File
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| file | bytearray |
Return type
URDFProjectSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_activate_workflow
WorkflowSchema src_app_api_workflows_activate_workflow(uuid)Activate Workflow Activate a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
WorkflowSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_cancel_workflow_execution
WorkflowExecutionSchema src_app_api_workflows_cancel_workflow_execution(execution_uuid)Cancel Workflow Execution Cancel a running workflow execution.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| execution_uuid | str |
Return type
WorkflowExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_create_workflow
WorkflowSchema src_app_api_workflows_create_workflow(workflow_create_schema)Create Workflow Create a new workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workflow_create_schema | WorkflowCreateSchema |
Return type
WorkflowSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_create_workflow_connection
WorkflowConnectionSchema src_app_api_workflows_create_workflow_connection(uuid, workflow_connection_create_schema)Create Workflow Connection Create a new connection between nodes.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workflow_connection_create_schema | WorkflowConnectionCreateSchema |
Return type
WorkflowConnectionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_create_workflow_node
WorkflowNodeSchema src_app_api_workflows_create_workflow_node(uuid, workflow_node_create_schema)Create Workflow Node Create a new node in a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workflow_node_create_schema | WorkflowNodeCreateSchema |
Return type
WorkflowNodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_deactivate_workflow
WorkflowSchema src_app_api_workflows_deactivate_workflow(uuid)Deactivate Workflow Deactivate a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
WorkflowSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_delete_workflow
src_app_api_workflows_delete_workflow(uuid)Delete Workflow Delete a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_delete_workflow_connection
src_app_api_workflows_delete_workflow_connection(uuid, connection_uuid)Delete Workflow Connection Delete a workflow connection.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| connection_uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_delete_workflow_node
src_app_api_workflows_delete_workflow_node(uuid, node_uuid)Delete Workflow Node Delete a workflow node.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| node_uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_edge_sync_workflows
Dict[str, object] src_app_api_workflows_edge_sync_workflows(twin_uuid)Edge Sync Workflows Sync workflows for an edge node. Returns active workflows with camera_frame triggers for the specified twin, along with resolved plugin requirements from MLModel metadata. Edge nodes call this to know:
- Which workflows to run
- Which plugins/models to install
- What events to emit
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| twin_uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_execute_workflow
WorkflowExecutionSchema src_app_api_workflows_execute_workflow(uuid, workflow_execute_schema)Execute Workflow Manually trigger a workflow execution.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workflow_execute_schema | WorkflowExecuteSchema |
Return type
WorkflowExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_execution_by_uuid
WorkflowExecutionSchema src_app_api_workflows_get_execution_by_uuid(execution_uuid)Get Execution By Uuid Get details of a specific execution by its UUID, including node executions.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| execution_uuid | str |
Return type
WorkflowExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_node_schema
Dict[str, object] src_app_api_workflows_get_node_schema(node_type, node_subtype=node_subtype)Get Node Schema Get the schema for a specific node type.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| node_type | str | ||
| node_subtype | str | [optional] |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_node_schemas
List[Dict[str, object]] src_app_api_workflows_get_node_schemas()Get Node Schemas Get all available node type schemas with their input/output definitions. This is used by the frontend to display available node types and their I/O.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[Dict[str, object]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_workflow
WorkflowSchema src_app_api_workflows_get_workflow(uuid)Get Workflow Get a specific workflow with its nodes and connections.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
WorkflowSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_workflow_execution
WorkflowExecutionSchema src_app_api_workflows_get_workflow_execution(uuid, execution_uuid)Get Workflow Execution Get a specific execution for a workflow with full details including node executions.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| execution_uuid | str |
Return type
WorkflowExecutionSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_get_workflow_node
WorkflowNodeSchema src_app_api_workflows_get_workflow_node(uuid, node_uuid)Get Workflow Node Get a specific node.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| node_uuid | str |
Return type
WorkflowNodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_list_workflow_connections
List[WorkflowConnectionSchema] src_app_api_workflows_list_workflow_connections(uuid)List Workflow Connections List all connections in a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[WorkflowConnectionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_list_workflow_executions
List[WorkflowExecutionSchema] src_app_api_workflows_list_workflow_executions(uuid)List Workflow Executions List all executions for a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[WorkflowExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_list_workflow_nodes
List[WorkflowNodeSchema] src_app_api_workflows_list_workflow_nodes(uuid)List Workflow Nodes List all nodes in a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
List[WorkflowNodeSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_list_workflows
List[WorkflowSchema] src_app_api_workflows_list_workflows()List Workflows List all workflows for the authenticated user’s workspace.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[WorkflowSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_update_workflow
WorkflowSchema src_app_api_workflows_update_workflow(uuid, workflow_update_schema)Update Workflow Update a workflow.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workflow_update_schema | WorkflowUpdateSchema |
Return type
WorkflowSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_update_workflow_node
WorkflowNodeSchema src_app_api_workflows_update_workflow_node(uuid, node_uuid, workflow_node_update_schema)Update Workflow Node Update a workflow node.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| node_uuid | str | ||
| workflow_node_update_schema | WorkflowNodeUpdateSchema |
Return type
WorkflowNodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_app_api_workflows_validate_node_inputs
Dict[str, object] src_app_api_workflows_validate_node_inputs(node_uuid)Validate Node Inputs Validate that a node’s input mappings are complete and correct. Returns validation status and any error messages.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| node_uuid | str |
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_add_organization_member_by_email
AddMemberByEmailResponse src_users_api_organizations_add_organization_member_by_email(uuid, add_member_by_email_request)Add Organization Member By Email Add a member to an organization by email address. If user exists in Cyberwave, add them to the organization. If user doesn’t exist, return user_exists=False so frontend can show contact link.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| add_member_by_email_request | AddMemberByEmailRequest |
Return type
AddMemberByEmailResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_create_organization
Dict[str, OrganizationSchema] src_users_api_organizations_create_organization(organization_create_schema)Create Organization Create a new organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| organization_create_schema | OrganizationCreateSchema |
Return type
Dict[str, OrganizationSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_delete_organization
src_users_api_organizations_delete_organization(uuid)Delete Organization Delete an organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_get_organization
Dict[str, OrganizationSchema] src_users_api_organizations_get_organization(uuid)Get Organization Retrieve an organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, OrganizationSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_get_organization_by_slug
Dict[str, OrganizationSchema] src_users_api_organizations_get_organization_by_slug(slug)Get Organization By Slug
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| slug | str |
Return type
Dict[str, OrganizationSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_list_organization_members
OrgMembersResponse src_users_api_organizations_list_organization_members(uuid)List Organization Members List all members of an organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
OrgMembersResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_list_organization_workspaces
Dict[str, List[OrganizationWorkspaceSchema]] src_users_api_organizations_list_organization_workspaces(uuid)List Organization Workspaces List all workspaces in an organization for authorized org users.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
Dict[str, List[OrganizationWorkspaceSchema]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_list_organizations
Dict[str, List[OrganizationSchema]] src_users_api_organizations_list_organizations()List Organizations List all organizations
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
Dict[str, List[OrganizationSchema]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_remove_organization_member
src_users_api_organizations_remove_organization_member(uuid, user_uuid)Remove Organization Member Remove a member from an organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| user_uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_update_organization
Dict[str, OrganizationSchema] src_users_api_organizations_update_organization(uuid, organization_update_schema)Update Organization Update an organization
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| organization_update_schema | OrganizationUpdateSchema |
Return type
Dict[str, OrganizationSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_organizations_update_organization_member_role
UpdateMemberRoleResponse src_users_api_organizations_update_organization_member_role(uuid, user_uuid, update_member_role_request)Update Organization Member Role Update the role of an organization member. Only organization owner or admin can update roles. Cannot change the role of the organization owner.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| user_uuid | str | ||
| update_member_role_request | UpdateMemberRoleRequest |
Return type
UpdateMemberRoleResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_plans_get_plan
PlanSchema src_users_api_plans_get_plan()Get Plan Get the plan for the current user
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
PlanSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_add_workspace_member_by_email
AddMemberByEmailResponse src_users_api_workspaces_add_workspace_member_by_email(uuid, add_member_by_email_request)Add Workspace Member By Email Add a member to a workspace by email address. If user exists in Cyberwave, add them to the workspace. If user doesn’t exist, return user_exists=False so frontend can show contact link.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| add_member_by_email_request | AddMemberByEmailRequest |
Return type
AddMemberByEmailResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_check_workspace_slug
SlugAvailabilitySchema src_users_api_workspaces_check_workspace_slug(slug)Check Workspace Slug Check if a workspace slug is available
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| slug | str |
Return type
SlugAvailabilitySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_create_workspace
WorkspaceSchema src_users_api_workspaces_create_workspace(workspace_create_schema=workspace_create_schema)Create Workspace Create a workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workspace_create_schema | WorkspaceCreateSchema | [optional] |
Return type
WorkspaceSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_delete_workspace
src_users_api_workspaces_delete_workspace(uuid)Delete Workspace Delete a workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_get_default_workspace
WorkspaceSchema src_users_api_workspaces_get_default_workspace()Get Default Workspace Get the user’s default workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
WorkspaceSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_get_vendor_description
VendorDescriptionSchema src_users_api_workspaces_get_vendor_description(slug)Get Vendor Description Get vendor description by slug (no authentication required)
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| slug | str |
Return type
VendorDescriptionSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_get_workspace
WorkspaceResponseSchema src_users_api_workspaces_get_workspace(uuid)Get Workspace Retrieve a workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str |
Return type
WorkspaceResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_get_workspace_by_slug
WorkspaceSchema src_users_api_workspaces_get_workspace_by_slug(slug)Get Workspace By Slug Retrieve a workspace by slug (public endpoint)
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| slug | str |
Return type
WorkspaceSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_leave_team
src_users_api_workspaces_leave_team(team_uuid, uuid)Leave Team Leave a team
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| team_uuid | str | ||
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_list_team_members
List[TeamMemberResponse] src_users_api_workspaces_list_team_members(team_uuid)List Team Members Get the members of a team
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| team_uuid | str |
Return type
List[TeamMemberResponse]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_list_workspaces
List[WorkspaceSchema] src_users_api_workspaces_list_workspaces()List Workspaces List all workspaces
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
This endpoint does not need any parameter.Return type
List[WorkspaceSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_remove_team_member
src_users_api_workspaces_remove_team_member(team_uuid, uuid)Remove Team Member Delete a member from a team
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| team_uuid | str | ||
| uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_remove_workspace_member
RemoveMemberResponse src_users_api_workspaces_remove_workspace_member(uuid, user_uuid)Remove Workspace Member Remove a member from a workspace. Only workspace owner or organization owner can remove members. Cannot remove the workspace owner or the last member.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| user_uuid | str |
Return type
RemoveMemberResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_set_default_workspace
src_users_api_workspaces_set_default_workspace(workspace_uuid)Set Default Workspace Set the user’s default workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| workspace_uuid | str |
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_update_workspace
WorkspaceSchema src_users_api_workspaces_update_workspace(uuid, workspace_update_schema)Update Workspace Update a workspace
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| workspace_update_schema | WorkspaceUpdateSchema |
Return type
WorkspaceSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |
src_users_api_workspaces_update_workspace_member_role
UpdateMemberRoleResponse src_users_api_workspaces_update_workspace_member_role(uuid, user_uuid, update_member_role_request)Update Workspace Member Role Update the role of a workspace member. Only workspace owner or organization owner/admin can update roles. Cannot change the role of the workspace owner.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| uuid | str | ||
| user_uuid | str | ||
| update_member_role_request | UpdateMemberRoleRequest |
Return type
UpdateMemberRoleResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | OK | - |