Skip to main content

cyberwave.rest.DefaultApi

All URIs are relative to http://localhost

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

Return type

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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

AlertSchema

Authorization

CustomTokenAuthentication

HTTP 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 required

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

DeferredTaskExecutionResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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)
This endpoint supports both authenticated and anonymous access for public assets.

Example

Parameters

Return type

void (empty response body)

Authorization

No authorization required

HTTP 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

AssetSchema

Authorization

No authorization required

HTTP 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 required

HTTP 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 required

HTTP 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 required

HTTP 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 required

HTTP 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

PopularTagsResponseSchema

Authorization

No authorization required

HTTP 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 required

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

InitiateLargeUploadResponse

Authorization

CustomTokenAuthentication

HTTP 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 required

HTTP 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

LLMResponseSchema

Authorization

No authorization required

HTTP 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.
When capabilities are patched, they are validated using CapabilitiesValidator. Body:
Returns:

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

AssetSchema

Authorization

CustomTokenAuthentication

HTTP 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

VLMResponseSchema

Authorization

No authorization required

HTTP 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

AttachmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

AttachmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

AttachmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

InitiateLargeUploadResponse

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

AttachmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

AttachmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

ControllerPolicySchema

Authorization

CustomTokenAuthentication

HTTP 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

ControllerPolicySchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

ControllerPolicyExecuteResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

str

Authorization

CustomTokenAuthentication

HTTP 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

ControllerPolicySchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

ControllerPolicySchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

DatasetSchema

Authorization

CustomTokenAuthentication

HTTP 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

DatasetZipUrlSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

DatasetSchema

Authorization

CustomTokenAuthentication

HTTP 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

DatasetSchema

Authorization

CustomTokenAuthentication

HTTP 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

DiscoveryResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

TwinBindingSchema

Authorization

CustomTokenAuthentication

HTTP 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

EdgeCoreRestartResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EdgeSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EdgeSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EdgeSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSnapshotSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

RecordingGenerationResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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
Composes schema from all twins and exports to MuJoCo format.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSnapshotSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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
Composes schema from all twins and exports to URDF format.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP 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

PermissionsSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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
The scene must have been exported by Cyberwave (must contain the extensions.cyberwave.twins registry in the XML comments/schema metadata). Multipart form field: file (.xml or .zip) Query param: replace_existing (bool, default false)

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ImportResultSchema

Authorization

CustomTokenAuthentication

HTTP 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

ImportResultSchema

Authorization

CustomTokenAuthentication

HTTP 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

ImportResultSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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:
  1. Discover all twins in the environment
  2. Find all sessions for each twin
  3. Queue recording generation tasks for each session
Returns information about queued tasks.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

EnvironmentSchema

Authorization

CustomTokenAuthentication

HTTP 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

EnvironmentSnapshotSchema

Authorization

CustomTokenAuthentication

HTTP 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

TwinTelemetryMetadataSchema

Authorization

CustomTokenAuthentication

HTTP 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

EpisodeSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EpisodeSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

EpisodeSchema

Authorization

CustomTokenAuthentication

HTTP 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

BusinessEventSchema

Authorization

CustomTokenAuthentication

HTTP 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

BusinessEventListResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

DeferredTaskExecutionResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

KeybindingSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

KeybindingSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP 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

KeybindingSchema

Authorization

CustomTokenAuthentication

HTTP 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

EndSessionResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

EndSessionResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

AdminLabOverviewSchema

Authorization

CustomTokenAuthentication

HTTP 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

LabStatusResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

LabAccessResponseSchema

Authorization

CustomTokenAuthentication

HTTP 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

MapDataSchema

Authorization

CustomTokenAuthentication

HTTP 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

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined