cyberwave.rest.DefaultApi
All URIs are relative to http://localhostsrc_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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_alerts_delete_alert
src_app_api_alerts_delete_alert(uuid)Delete Alert Delete an alert.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[AlertSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
AlertSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
void (empty response body)Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_assets_create_asset
AssetSchema src_app_api_assets_create_asset(asset_create_schema)Create Asset
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
DeferredTaskExecutionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/x-www-form-urlencoded
- Accept: application/json
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
src_app_api_assets_delete_asset
src_app_api_assets_delete_asset(uuid)Delete Asset
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
AssetSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
src_app_api_assets_get_asset_controllers
List[ControllerPolicySchema] src_app_api_assets_get_asset_controllers(uuid)Get Asset Controllers
Example
Parameters
Return type
List[ControllerPolicySchema]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
No authorization requiredHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
InitiateLargeUploadResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
src_app_api_assets_llm_generation
LLMResponseSchema src_app_api_assets_llm_generation(uuid, llm_generation_schema)Llm Generation
Example
Parameters
Return type
LLMResponseSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_assets_upload_glb
AssetSchema src_app_api_assets_upload_glb(uuid, file)Upload Glb
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
AssetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
VLMResponseSchemaAuthorization
No authorization requiredHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_attachments_create_attachment
AttachmentSchema src_app_api_attachments_create_attachment(attachment_create_schema)Create Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_attachments_delete_attachment
src_app_api_attachments_delete_attachment(uuid)Delete Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
src_app_api_attachments_get_attachment
AttachmentSchema src_app_api_attachments_get_attachment(uuid)Get Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
InitiateLargeUploadResponseAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
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
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_attachments_upload_attachment
AttachmentSchema src_app_api_attachments_upload_attachment(uuid, file)Upload Attachment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
AttachmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
ControllerPolicyExecuteResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
strAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[ControllerPolicySchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
ControllerPolicySchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
DatasetZipUrlSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
DatasetSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
DiscoveryResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
List[TwinBindingSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
TwinBindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EdgeCoreRestartResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: Not defined
HTTP response details
src_app_api_edges_create_edge
EdgeSchema src_app_api_edges_create_edge(edge_create_schema)Create Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_edges_delete_edge
src_app_api_edges_delete_edge(uuid)Delete Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
src_app_api_edges_get_edge
EdgeSchema src_app_api_edges_get_edge(uuid)Get Edge
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
Return type
EdgeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
src_app_api_environments_get_environment_waypoints
EnvironmentWaypointSchema[] src_app_api_environments_get_environment_waypoints(uuid)Get Environment Waypoints List environment waypoints.
Parameters
Return type
EnvironmentWaypointSchema[]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_environments_delete_environment
src_app_api_environments_delete_environment(uuid)Delete Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
RecordingGenerationResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_environments_get_environment
EnvironmentSchema src_app_api_environments_get_environment(uuid)Get Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[Dict[str, object]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, Optional[str]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[TwinSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
PermissionsSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
ImportResultSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
Return type
List[MissionExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[EnvironmentSnapshotSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[TaskExecutionSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[EnvironmentSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
src_app_api_environments_reset_environment
Dict[str, object] src_app_api_environments_reset_environment(uuid)Reset Environment
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EnvironmentSnapshotSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
TwinTelemetryMetadataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
Dict[str, Optional[bool]]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
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
Return type
EpisodeSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
BusinessEventSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
BusinessEventListResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
DeferredTaskExecutionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
List[DeferredTaskExecutionResponseSchema]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
Dict[str, object]Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
src_app_api_keybindings_delete_keybinding
src_app_api_keybindings_delete_keybinding(uuid)Delete Keybinding Delete a keybinding.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
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
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
Return type
KeybindingSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
EndSessionResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
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
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
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
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
Return type
LabAccessResponseSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
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
Return type
MapDataSchemaAuthorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: multipart/form-data
- Accept: application/json
HTTP response details
src_app_api_maps_delete_map
src_app_api_maps_delete_map(uuid)Delete Map Delete a map.
Example
- Api Key Authentication (CustomTokenAuthentication):
Parameters
Return type
void (empty response body)Authorization
CustomTokenAuthenticationHTTP request headers
- Content-Type: Not defined
- Accept: Not defined