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

HTTP response details

src_app_api_maps_download_map_data

src_app_api_maps_download_map_data(uuid)
Download Map Data Download map data file.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_maps_finalize_stream_map

MapDataSchema src_app_api_maps_finalize_stream_map(uuid, resolution=resolution, origin_x=origin_x, origin_y=origin_y, origin_z=origin_z, origin_roll=origin_roll, origin_pitch=origin_pitch, origin_yaw=origin_yaw, metadata=metadata, file=file)
Finalize Stream Map Finalize a stream-started map by uploading the real map file.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MapDataSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

HTTP response details

src_app_api_maps_get_map

MapDataSchema src_app_api_maps_get_map(uuid)
Get Map Get map metadata by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MapDataSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_maps_get_map_image

src_app_api_maps_get_map_image(uuid)
Get Map Image Return the map data file converted to PNG (supports PGM, PBM, PPM, etc.).

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_maps_list_environment_maps

List[MapDataSchema] src_app_api_maps_list_environment_maps(uuid)
List Environment Maps List all maps in an environment (including maps from twins in that environment).

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[MapDataSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_maps_list_maps

List[MapDataSchema] src_app_api_maps_list_maps()
List Maps List all maps accessible to the user.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[MapDataSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_maps_list_twin_maps

List[MapDataSchema] src_app_api_maps_list_twin_maps(uuid)
List Twin Maps List maps for a specific twin.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[MapDataSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_maps_start_map_from_stream

MapDataSchema src_app_api_maps_start_map_from_stream(map_stream_start_schema)
Start Map From Stream Create a map entry to receive updates from a live stream.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MapDataSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_maps_stop_map_from_stream

MapDataSchema src_app_api_maps_stop_map_from_stream(map_stream_stop_schema)
Stop Map From Stream Queue a stop/finalize request for the active streaming map.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MapDataSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_missions_cancel_mission_execution

src_app_api_missions_cancel_mission_execution(twin_uuid, mission_uuid, uuid)
Cancel Mission Execution Cancel a mission execution.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_missions_create_mission

MissionSchema src_app_api_missions_create_mission(uuid, create_mission_schema)
Create Mission Create a mission definition (sequential task list).

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MissionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_missions_delete_mission

src_app_api_missions_delete_mission(twin_uuid, uuid)
Delete Mission Delete a mission definition.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_missions_execute_mission

MissionExecutionSchema src_app_api_missions_execute_mission(twin_uuid, uuid, create_mission_execution_schema)
Execute Mission Execute a mission (create a mission execution).

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MissionExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_missions_get_mission

MissionSchema src_app_api_missions_get_mission(twin_uuid, uuid)
Get Mission Get a mission definition by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MissionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_missions_get_mission_execution

MissionExecutionSchema src_app_api_missions_get_mission_execution(twin_uuid, mission_uuid, uuid)
Get Mission Execution Get a mission execution by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MissionExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_missions_list_mission_executions

List[MissionExecutionSchema] src_app_api_missions_list_mission_executions(twin_uuid, uuid, status=status, limit=limit)
List Mission Executions List executions for a mission definition.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[MissionExecutionSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_missions_list_missions

List[MissionSchema] src_app_api_missions_list_missions(uuid)
List Missions List mission definitions for a twin.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[MissionSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mlmodels_create_mlmodel

MLModelSchema src_app_api_mlmodels_create_mlmodel(ml_model_create_schema)
Create Mlmodel Create a new ML model.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MLModelSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_mlmodels_delete_mlmodel

src_app_api_mlmodels_delete_mlmodel(uuid)
Delete Mlmodel Delete an ML model.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_mlmodels_get_mlmodel

MLModelSchema src_app_api_mlmodels_get_mlmodel(uuid)
Get Mlmodel Get a specific ML model by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MLModelSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mlmodels_get_mlmodel_weights

Dict[str, Optional[str]] src_app_api_mlmodels_get_mlmodel_weights(uuid)
Get Mlmodel Weights Get a signed URL for downloading the ML model checkpoint weights. The checkpoint is expected to be a tar archive containing the model files (config.json, adapter files, etc.) from training. Returns: Dict with signed_url and expires_at fields

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, Optional[str]]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mlmodels_list_mlmodels

List[MLModelSchema] src_app_api_mlmodels_list_mlmodels(deployment=deployment, edge_compatible=edge_compatible)
List Mlmodels List all ML models for the authenticated user’s workspace. Query params: deployment: Filter by deployment type (cloud, edge, hybrid) edge_compatible: If true, return only edge or hybrid models

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[MLModelSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mlmodels_update_mlmodel

MLModelSchema src_app_api_mlmodels_update_mlmodel(uuid, ml_model_update_schema)
Update Mlmodel Update an existing ML model.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MLModelSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_create_mltraining

Response src_app_api_mltrainings_create_mltraining(ml_training_create_schema)
Create Mltraining Create a new ML training.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Response

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_delete_mltraining

Dict[str, object] src_app_api_mltrainings_delete_mltraining(uuid)
Delete Mltraining Delete an ML training.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_deploy_mltraining

Dict[str, object] src_app_api_mltrainings_deploy_mltraining(uuid, ml_training_deploy_schema)
Deploy Mltraining Deploy a completed ML training to one or more twins. The deployment process:
  1. Export the trained model weights
  2. Create a new ControllerPolicy (type: mlmodel) with the trained model
  3. Assign the controller policy to the specified twins
TODO: Implement actual deployment logic:
  • Export trained model weights to storage
  • Create ControllerPolicy with type=‘mlmodel’ and model reference
  • Update each twin’s controller_policy FK to the new policy
  • Optionally start inference service

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_get_deployed_mltrainings

List[MLTrainingSchema] src_app_api_mltrainings_get_deployed_mltrainings()
Get Deployed Mltrainings Get all deployed ML trainings for the authenticated user’s workspaces.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[MLTrainingSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_get_mltraining

MLTrainingSchema src_app_api_mltrainings_get_mltraining(uuid)
Get Mltraining Get a specific ML training by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MLTrainingSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_list_mltrainings_for_user_workspaces

List[MLTrainingSchema] src_app_api_mltrainings_list_mltrainings_for_user_workspaces()
List Mltrainings For User Workspaces List all ML trainings for the authenticated user’s workspaces.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[MLTrainingSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_mltrainings_update_mltraining

MLTrainingSchema src_app_api_mltrainings_update_mltraining(uuid, ml_training_update_schema)
Update Mltraining Update an ML training.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

MLTrainingSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_navigation_execute_twin_navigation

TwinActionResponseSchema src_app_api_navigation_execute_twin_navigation(uuid, twin_navigation_command_schema)
Execute Twin Navigation

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinActionResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_projects_create_project

ProjectSchema src_app_api_projects_create_project(project_create_schema)
Create Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_projects_create_project_link

src_app_api_projects_create_project_link(uuid, link_share_create_schema)
Create Project Link Create a shareable link for a project.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

HTTP response details

src_app_api_projects_delete_project

src_app_api_projects_delete_project(uuid)
Delete 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_projects_get_my_project_permissions

PermissionsSchema src_app_api_projects_get_my_project_permissions(uuid)
Get My Project Permissions Get current user’s permissions on this project.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

PermissionsSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_projects_get_project

ProjectSchema src_app_api_projects_get_project(uuid)
Get Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_projects_get_project_shares

SharesResponseSchema src_app_api_projects_get_project_shares(uuid)
Get Project Shares List all shares for a project.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

SharesResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_projects_invite_user_to_project

Dict[str, object] src_app_api_projects_invite_user_to_project(uuid)
Invite User To Project Invite a non-existent user to a project.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_projects_list_projects

List[ProjectSchema] src_app_api_projects_list_projects()
List Projects List all projects visible to the current user.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[ProjectSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_projects_revoke_project_link

src_app_api_projects_revoke_project_link(uuid, link_share_revoke_schema)
Revoke Project Link Revoke a shareable link.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

HTTP response details

src_app_api_projects_share_project

ProjectShareResponseSchema src_app_api_projects_share_project(uuid, share_schema)
Share Project Share a project with a user or team.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ProjectShareResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_projects_unshare_project

ProjectShareResponseSchema src_app_api_projects_unshare_project(uuid, share_schema)
Unshare Project Remove sharing permissions for a user or team.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ProjectShareResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_projects_update_project

ProjectSchema src_app_api_projects_update_project(uuid, project_create_schema)
Update Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

ProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_tagged_frames_create_tagged_frames

TaggedFramesSchema src_app_api_tagged_frames_create_tagged_frames(tagged_frames_create_schema)
Create Tagged Frames Create a new tagged frames entry.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaggedFramesSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_tagged_frames_delete_tagged_frames

src_app_api_tagged_frames_delete_tagged_frames(uuid)
Delete Tagged Frames Delete a tagged frames entry by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_tagged_frames_get_tagged_frames

TaggedFramesSchema src_app_api_tagged_frames_get_tagged_frames(uuid)
Get Tagged Frames Get a specific tagged frames by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaggedFramesSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tagged_frames_list_tagged_frames

List[TaggedFramesSchema] src_app_api_tagged_frames_list_tagged_frames(recording_uuid=recording_uuid)
List Tagged Frames List all tagged frames accessible by the user. Optionally filter by recording_uuid.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TaggedFramesSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tagged_frames_update_tagged_frames

TaggedFramesSchema src_app_api_tagged_frames_update_tagged_frames(uuid, tagged_frames_update_schema)
Update Tagged Frames Update an existing tagged frames entry.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaggedFramesSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_tasks_cancel_task_execution

src_app_api_tasks_cancel_task_execution(uuid)
Cancel Task Execution Cancel a task execution.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_tasks_create_task

TaskSchema src_app_api_tasks_create_task(create_task_schema)
Create Task Create a reusable task definition.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaskSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_tasks_delete_task

src_app_api_tasks_delete_task(uuid)
Delete Task Delete a task.

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_tasks_execute_task

TaskExecutionSchema src_app_api_tasks_execute_task(uuid, execute_task_schema)
Execute Task Execute a task on a twin (standalone, not part of mission).

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaskExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_tasks_get_task

TaskSchema src_app_api_tasks_get_task(uuid)
Get Task Get a task by UUID.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaskSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tasks_get_task_execution

TaskExecutionSchema src_app_api_tasks_get_task_execution(uuid)
Get Task Execution

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaskExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tasks_list_task_queue

List[TaskExecutionSchema] src_app_api_tasks_list_task_queue(status=status, environment_uuid=environment_uuid, twin_uuid=twin_uuid, task_type=task_type, limit=limit)
List Task Queue List task executions (the order queue). Filters:
  • status: Filter by status (pending, queued, running, completed, failed, cancelled) Can be comma-separated for multiple: “pending,queued,running”
  • environment_uuid: Filter by environment
  • twin_uuid: Filter by specific twin
  • task_type: Filter by task type (navigation, motion, mlmodel)
  • limit: Max results (default 100)
Examples:
  • GET /tasks/queue?status=pending,queued,running (active queue)
  • GET /tasks/queue?status=running (currently executing)
  • GET /tasks/queue?environment_uuid=xxx&status=pending

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TaskExecutionSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tasks_list_tasks

List[TaskSchema] src_app_api_tasks_list_tasks(workspace_uuid=workspace_uuid, task_type=task_type)
List Tasks List tasks in workspace.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TaskSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_tasks_update_task

TaskSchema src_app_api_tasks_update_task(uuid, update_task_schema)
Update Task Update a task.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TaskSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_twins_create_twin

TwinSchema src_app_api_twins_create_twin(twin_create_schema)
Create Twin

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_twins_delete_twin

src_app_api_twins_delete_twin(uuid)
Delete Twin

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_twins_execute_twin_action

TwinActionResponseSchema src_app_api_twins_execute_twin_action(uuid, twin_action_request_schema)
Execute Twin Action

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinActionResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_twins_get_recording

TwinConnectionEventSchema src_app_api_twins_get_recording(recording_uuid)
Get Recording Get a specific recording by UUID. Returns TWIN_RECORDING_INFO event with full metadata. Includes signed_url for mp4_path if available.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinConnectionEventSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin

TwinSchema src_app_api_twins_get_twin(uuid)
Get Twin

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_action_status

TwinActionStatusSchema src_app_api_twins_get_twin_action_status(uuid, action_id)
Get Twin Action Status

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinActionStatusSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_calibration

TwinJointCalibrationSchema src_app_api_twins_get_twin_calibration(uuid)
Get Twin Calibration

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinJointCalibrationSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_connection_history

List[TwinConnectionEventSchema] src_app_api_twins_get_twin_connection_history(uuid, limit=limit)
Get Twin Connection History Get the connection history for a twin. Returns recent telemetry events like connected, disconnected, telemetry_start, telemetry_end.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TwinConnectionEventSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_driver_logs

TwinDriverLogsResponseSchema src_app_api_twins_get_twin_driver_logs(uuid, limit=limit, offset=offset)
Get Twin Driver Logs Get persisted driver logs for a twin, newest-first. Query params:
  • limit: max rows to return (default 100, max 500)
  • offset: number of rows to skip (default 0)

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinDriverLogsResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_latest_frame

src_app_api_twins_get_twin_latest_frame(uuid, mock=mock)
Get Twin Latest Frame Get the latest frame from a twin’s camera stream. Serves the frame directly from Redis without saving to permanent storage. For multi-camera twins, the media service stores frames with key frame:{twin*uuid}*{sensor_id}:rgb:latest. Pass ?sensor_id=wrist_camera to get a specific camera. Query params:
  • mock: if true, return a deterministic mock JPEG payload.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_twins_get_twin_latest_metrics

src_app_api_twins_get_twin_latest_metrics(uuid)
Get Twin Latest Metrics Get the latest metrics snapshot for a twin. Returns the most recent metrics from Twin.metadata (current state) plus the timestamp of the last update. This is more efficient than querying historical data when you only need the current state.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_twins_get_twin_links

List[Optional[str]] src_app_api_twins_get_twin_links(uuid)
Get Twin Links Get list of available links in a twin’s schema for docking. Returns a list of link names that can be used as attachment points when docking other twins to this twin.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[Optional[str]]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_metrics

List[TwinMetricsQuerySchema] src_app_api_twins_get_twin_metrics(uuid, start=start, end=end, limit=limit)
Get Twin Metrics Get historical metrics for a twin. Returns time-series metrics data (battery level, navigation status, etc.) logged via MQTT from edge devices. Args: uuid: Twin UUID start: Start datetime (ISO format, e.g., “2026-01-01T00:00:00Z”) end: End datetime (ISO format) limit: Max results (default 100, max 1000) Returns: List of metrics snapshots ordered by timestamp (newest first) Examples: GET /twins/{uuid}/metrics GET /twins/{uuid}/metrics?start=2026-01-20T00:00:00Z&limit=500 GET /twins/{uuid}/metrics?start=2026-01-01&end=2026-01-21

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TwinMetricsQuerySchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_motions

TwinMotionResponseSchema src_app_api_twins_get_twin_motions(uuid, environment_uuid=environment_uuid)
Get Twin Motions

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinMotionResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_notebook

src_app_api_twins_get_twin_notebook(uuid)
Get Twin Notebook Generate and serve a Jupyter notebook for this twin. This endpoint is public so Google Colab can fetch it directly. Usage: https://colab.research.google.com/#fileId=<api_url>/twins/{uuid}/notebook.ipynb

Example

Parameters

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_twins_get_twin_recordings

List[TwinConnectionEventSchema] src_app_api_twins_get_twin_recordings(uuid)
Get Twin Recordings Get all recordings for a twin. Returns TWIN_RECORDING_INFO events (parquet recordings) for camera twins. Only returns recordings that have mp4_path (camera recordings). Includes signed_url in metadata for each recording.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TwinConnectionEventSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_relationships

List[TwinRelationshipSchema] src_app_api_twins_get_twin_relationships(uuid)
Get Twin Relationships MVP: Generate mock relationships based on twin names and environment

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TwinRelationshipSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_get_twin_universal_schema_at_path

Dict[str, object] src_app_api_twins_get_twin_universal_schema_at_path(uuid, path=path)
Get Twin Universal Schema At Path Get value at a specific JSON Pointer path in the twin’s universal schema. Query params: path: JSON Pointer path (e.g., /sensors/0, /extensions/cyberwave/capabilities) Returns: {"path": "...", "value": <any json>}

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_link_occupancy_map

src_app_api_twins_link_occupancy_map(uuid, occupancy_map_create_schema)
Link Occupancy Map Link an occupancy-grid map to this twin, compute (or retrieve) the world->map transform, and send it to the edge via MQTT. The map must have been uploaded beforehand via POST /maps (with map_type=occupancy_grid). Flow:
  1. Validate and associate the map with the twin.
  2. If the environment already has a manually-set navigation transform, use it. Otherwise, attempt to auto-align the SLAM map with the 3D scene (currently mocked as identity).
  3. Save the transform into environment.settings.navigation.
  4. Publish the transform on the occupancy-map-tf MQTT topic so the edge waypoint bridge sets its world -> map TF.

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_twins_list_all_twins

List[TwinSchema] src_app_api_twins_list_all_twins()
List All Twins

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[TwinSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_patch_twin_universal_schema

Dict[str, object] src_app_api_twins_patch_twin_universal_schema(uuid, twin_universal_schema_patch_schema)
Patch Twin Universal Schema Update the twin’s universal schema using JSON Pointer operations. This allows editing twin-specific schema overrides, such as:
  • /sensors (array of sensor objects)
  • /extensions/cyberwave/capabilities
Note: Unlike Asset schema, Twin schema PATCH does NOT update a hash (twin schema is a snapshot, not authoritative). 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_twins_reload_twin_capabilities

Dict[str, object] src_app_api_twins_reload_twin_capabilities(uuid)
Reload Twin Capabilities Get capabilities from Twin.universal_schema. Note: Capabilities are now derived from schema only, not cached in DB. This endpoint is kept for backward compatibility. Returns:

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_reload_twins_capabilities_bulk

Dict[str, object] src_app_api_twins_reload_twins_capabilities_bulk(reload_capabilities_bulk_schema)
Reload Twins Capabilities Bulk Bulk reload capabilities for multiple twins. Filters:
  • environment_uuid: Reload all twins in an environment
  • twin_uuids: Reload specific twins by UUID
If both are provided, twins must match both criteria. If neither is provided, returns error. 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_twins_sync_twin_with_asset

SyncWithAssetSchema src_app_api_twins_sync_twin_with_asset(uuid)
Sync Twin With Asset Sync twin metadata and universal_schema with its parent asset. This updates the twin’s metadata with the latest values from the asset for fields that are typically defined at the asset level (like locomotion_animations). Fields that are twin-specific (like controller assignments) are preserved. Note: This also re-snapshots the twin’s universal_schema from the asset, overwriting any twin-specific schema edits made via PATCH /api/v1/twins/{uuid}/universal-schema.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

SyncWithAssetSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_twins_update_twin

TwinSchema src_app_api_twins_update_twin(uuid, twin_create_schema)
Update Twin Update a twin’s properties. Note: When changing the asset_uuid, the twin’s universal_schema will be re-snapshotted from the new asset, overwriting any twin-specific schema edits made via PATCH /api/v1/twins/{uuid}/universal-schema.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_twins_update_twin_calibration

TwinJointCalibrationSchema src_app_api_twins_update_twin_calibration(uuid, twin_joint_calibration_schema)
Update Twin Calibration

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinJointCalibrationSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_twins_update_twin_state

TwinSchema src_app_api_twins_update_twin_state(uuid, twin_state_update_schema)
Update Twin State

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

TwinSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_urdf_create_urdf_project

URDFProjectSchema src_app_api_urdf_create_urdf_project(urdf_project_create_schema)
Create Urdf Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

URDFProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_urdf_delete_urdf_project

src_app_api_urdf_delete_urdf_project(uuid)
Delete Urdf 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_urdf_fix_urdf_project_slug

URDFProjectSchema src_app_api_urdf_fix_urdf_project_slug(uuid, new_slug, new_main_file_path)
Fix Urdf Project Slug Fix a URDF project’s slug and main_file_path to match actual storage. This is useful when files exist in storage but the DB record points to the wrong location. Requires staff/superuser permissions.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

URDFProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_twin_joint_state

JointStateSchema src_app_api_urdf_get_twin_joint_state(uuid, joint_name)
Get Twin Joint State

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

JointStateSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_twin_joint_states

JointStatesSchema src_app_api_urdf_get_twin_joint_states(uuid)
Get Twin Joint States

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

JointStatesSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_twin_joints

List[JointSchema] src_app_api_urdf_get_twin_joints(uuid)
Get Twin Joints

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[JointSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_twin_robot_description

RobotDescriptionSchema src_app_api_urdf_get_twin_robot_description(uuid)
Get Twin Robot Description

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

RobotDescriptionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_twin_urdf_raw

str src_app_api_urdf_get_twin_urdf_raw(uuid)
Get Twin Urdf Raw

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

str

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_get_urdf_project

URDFProjectSchema src_app_api_urdf_get_urdf_project(uuid)
Get Urdf Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

URDFProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_list_urdf_projects

List[URDFProjectSchema] src_app_api_urdf_list_urdf_projects()
List Urdf Projects

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[URDFProjectSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_urdf_update_twin_joint_state

JointStateSchema src_app_api_urdf_update_twin_joint_state(uuid, joint_name, joint_state_update_schema)
Update Twin Joint State

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

JointStateSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_urdf_update_twin_joint_states

JointStatesSchema src_app_api_urdf_update_twin_joint_states(uuid, bulk_joint_states_update_schema)
Update Twin Joint States

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

JointStatesSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_urdf_update_urdf_project

URDFProjectSchema src_app_api_urdf_update_urdf_project(uuid, urdf_project_create_schema)
Update Urdf Project

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

URDFProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_urdf_upload_zip_file

URDFProjectSchema src_app_api_urdf_upload_zip_file(uuid, file)
Upload Zip File

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

URDFProjectSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

HTTP response details

src_app_api_workflows_activate_workflow

WorkflowSchema src_app_api_workflows_activate_workflow(uuid)
Activate Workflow Activate a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_cancel_workflow_execution

WorkflowExecutionSchema src_app_api_workflows_cancel_workflow_execution(execution_uuid)
Cancel Workflow Execution Cancel a running workflow execution.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_create_workflow

WorkflowSchema src_app_api_workflows_create_workflow(workflow_create_schema)
Create Workflow Create a new workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_create_workflow_connection

WorkflowConnectionSchema src_app_api_workflows_create_workflow_connection(uuid, workflow_connection_create_schema)
Create Workflow Connection Create a new connection between nodes.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowConnectionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_create_workflow_node

WorkflowNodeSchema src_app_api_workflows_create_workflow_node(uuid, workflow_node_create_schema)
Create Workflow Node Create a new node in a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowNodeSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_deactivate_workflow

WorkflowSchema src_app_api_workflows_deactivate_workflow(uuid)
Deactivate Workflow Deactivate a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_delete_workflow

src_app_api_workflows_delete_workflow(uuid)
Delete Workflow Delete a workflow.

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_workflows_delete_workflow_connection

src_app_api_workflows_delete_workflow_connection(uuid, connection_uuid)
Delete Workflow Connection Delete a workflow connection.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_workflows_delete_workflow_node

src_app_api_workflows_delete_workflow_node(uuid, node_uuid)
Delete Workflow Node Delete a workflow node.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_app_api_workflows_edge_sync_workflows

Dict[str, object] src_app_api_workflows_edge_sync_workflows(twin_uuid)
Edge Sync Workflows Sync workflows for an edge node. Returns active workflows with camera_frame triggers for the specified twin, along with resolved plugin requirements from MLModel metadata. Edge nodes call this to know:
  1. Which workflows to run
  2. Which plugins/models to install
  3. What events to emit

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_workflows_execute_workflow

WorkflowExecutionSchema src_app_api_workflows_execute_workflow(uuid, workflow_execute_schema)
Execute Workflow Manually trigger a workflow execution.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_execution_by_uuid

WorkflowExecutionSchema src_app_api_workflows_get_execution_by_uuid(execution_uuid)
Get Execution By Uuid Get details of a specific execution by its UUID, including node executions.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_node_schema

Dict[str, object] src_app_api_workflows_get_node_schema(node_type, node_subtype=node_subtype)
Get Node Schema Get the schema for a specific node type.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_node_schemas

List[Dict[str, object]] src_app_api_workflows_get_node_schemas()
Get Node Schemas Get all available node type schemas with their input/output definitions. This is used by the frontend to display available node types and their I/O.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[Dict[str, object]]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_workflow

WorkflowSchema src_app_api_workflows_get_workflow(uuid)
Get Workflow Get a specific workflow with its nodes and connections.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_workflow_execution

WorkflowExecutionSchema src_app_api_workflows_get_workflow_execution(uuid, execution_uuid)
Get Workflow Execution Get a specific execution for a workflow with full details including node executions.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowExecutionSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_get_workflow_node

WorkflowNodeSchema src_app_api_workflows_get_workflow_node(uuid, node_uuid)
Get Workflow Node Get a specific node.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowNodeSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_list_workflow_connections

List[WorkflowConnectionSchema] src_app_api_workflows_list_workflow_connections(uuid)
List Workflow Connections List all connections in a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[WorkflowConnectionSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_list_workflow_executions

List[WorkflowExecutionSchema] src_app_api_workflows_list_workflow_executions(uuid)
List Workflow Executions List all executions for a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[WorkflowExecutionSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_list_workflow_nodes

List[WorkflowNodeSchema] src_app_api_workflows_list_workflow_nodes(uuid)
List Workflow Nodes List all nodes in a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[WorkflowNodeSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_list_workflows

List[WorkflowSchema] src_app_api_workflows_list_workflows()
List Workflows List all workflows for the authenticated user’s workspace.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[WorkflowSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_app_api_workflows_update_workflow

WorkflowSchema src_app_api_workflows_update_workflow(uuid, workflow_update_schema)
Update Workflow Update a workflow.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_update_workflow_node

WorkflowNodeSchema src_app_api_workflows_update_workflow_node(uuid, node_uuid, workflow_node_update_schema)
Update Workflow Node Update a workflow node.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkflowNodeSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_app_api_workflows_validate_node_inputs

Dict[str, object] src_app_api_workflows_validate_node_inputs(node_uuid)
Validate Node Inputs Validate that a node’s input mappings are complete and correct. Returns validation status and any error messages.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, object]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_add_organization_member_by_email

AddMemberByEmailResponse src_users_api_organizations_add_organization_member_by_email(uuid, add_member_by_email_request)
Add Organization Member By Email Add a member to an organization by email address. If user exists in Cyberwave, add them to the organization. If user doesn’t exist, return user_exists=False so frontend can show contact link.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

AddMemberByEmailResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_organizations_create_organization

Dict[str, OrganizationSchema] src_users_api_organizations_create_organization(organization_create_schema)
Create Organization Create a new organization

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, OrganizationSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_organizations_delete_organization

src_users_api_organizations_delete_organization(uuid)
Delete Organization Delete an organization

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_users_api_organizations_get_organization

Dict[str, OrganizationSchema] src_users_api_organizations_get_organization(uuid)
Get Organization Retrieve an organization

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, OrganizationSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_get_organization_by_slug

Dict[str, OrganizationSchema] src_users_api_organizations_get_organization_by_slug(slug)
Get Organization By Slug

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, OrganizationSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_list_organization_members

OrgMembersResponse src_users_api_organizations_list_organization_members(uuid)
List Organization Members List all members of an organization

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

OrgMembersResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_list_organization_workspaces

Dict[str, List[OrganizationWorkspaceSchema]] src_users_api_organizations_list_organization_workspaces(uuid)
List Organization Workspaces List all workspaces in an organization for authorized org users.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, List[OrganizationWorkspaceSchema]]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_list_organizations

Dict[str, List[OrganizationSchema]] src_users_api_organizations_list_organizations()
List Organizations List all organizations

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

Dict[str, List[OrganizationSchema]]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_organizations_remove_organization_member

src_users_api_organizations_remove_organization_member(uuid, user_uuid)
Remove Organization Member Remove a member from an organization

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_users_api_organizations_update_organization

Dict[str, OrganizationSchema] src_users_api_organizations_update_organization(uuid, organization_update_schema)
Update Organization Update an organization

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

Dict[str, OrganizationSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_organizations_update_organization_member_role

UpdateMemberRoleResponse src_users_api_organizations_update_organization_member_role(uuid, user_uuid, update_member_role_request)
Update Organization Member Role Update the role of an organization member. Only organization owner or admin can update roles. Cannot change the role of the organization owner.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

UpdateMemberRoleResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_plans_get_plan

PlanSchema src_users_api_plans_get_plan()
Get Plan Get the plan for the current user

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

PlanSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_add_workspace_member_by_email

AddMemberByEmailResponse src_users_api_workspaces_add_workspace_member_by_email(uuid, add_member_by_email_request)
Add Workspace Member By Email Add a member to a workspace by email address. If user exists in Cyberwave, add them to the workspace. If user doesn’t exist, return user_exists=False so frontend can show contact link.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

AddMemberByEmailResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_workspaces_check_workspace_slug

SlugAvailabilitySchema src_users_api_workspaces_check_workspace_slug(slug)
Check Workspace Slug Check if a workspace slug is available

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

SlugAvailabilitySchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_create_workspace

WorkspaceSchema src_users_api_workspaces_create_workspace(workspace_create_schema=workspace_create_schema)
Create Workspace Create a workspace

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkspaceSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_workspaces_delete_workspace

src_users_api_workspaces_delete_workspace(uuid)
Delete Workspace Delete a workspace

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_users_api_workspaces_get_default_workspace

WorkspaceSchema src_users_api_workspaces_get_default_workspace()
Get Default Workspace Get the user’s default workspace

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

WorkspaceSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_get_vendor_description

VendorDescriptionSchema src_users_api_workspaces_get_vendor_description(slug)
Get Vendor Description Get vendor description by slug (no authentication required)

Example

Parameters

Return type

VendorDescriptionSchema

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_get_workspace

WorkspaceResponseSchema src_users_api_workspaces_get_workspace(uuid)
Get Workspace Retrieve a workspace

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkspaceResponseSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_get_workspace_by_slug

WorkspaceSchema src_users_api_workspaces_get_workspace_by_slug(slug)
Get Workspace By Slug Retrieve a workspace by slug (public endpoint)

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkspaceSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_leave_team

src_users_api_workspaces_leave_team(team_uuid, uuid)
Leave Team Leave a team

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_users_api_workspaces_list_team_members

List[TeamMemberResponse] src_users_api_workspaces_list_team_members(team_uuid)
List Team Members Get the members of a team

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

List[TeamMemberResponse]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_list_workspaces

List[WorkspaceSchema] src_users_api_workspaces_list_workspaces()
List Workspaces List all workspaces

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[WorkspaceSchema]

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_remove_team_member

src_users_api_workspaces_remove_team_member(team_uuid, uuid)
Remove Team Member Delete a member from a team

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_users_api_workspaces_remove_workspace_member

RemoveMemberResponse src_users_api_workspaces_remove_workspace_member(uuid, user_uuid)
Remove Workspace Member Remove a member from a workspace. Only workspace owner or organization owner can remove members. Cannot remove the workspace owner or the last member.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

RemoveMemberResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

src_users_api_workspaces_set_default_workspace

src_users_api_workspaces_set_default_workspace(workspace_uuid)
Set Default Workspace Set the user’s default workspace

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

void (empty response body)

Authorization

CustomTokenAuthentication

HTTP request headers

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

HTTP response details

src_users_api_workspaces_update_workspace

WorkspaceSchema src_users_api_workspaces_update_workspace(uuid, workspace_update_schema)
Update Workspace Update a workspace

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

WorkspaceSchema

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

src_users_api_workspaces_update_workspace_member_role

UpdateMemberRoleResponse src_users_api_workspaces_update_workspace_member_role(uuid, user_uuid, update_member_role_request)
Update Workspace Member Role Update the role of a workspace member. Only workspace owner or organization owner/admin can update roles. Cannot change the role of the workspace owner.

Example

  • Api Key Authentication (CustomTokenAuthentication):

Parameters

Return type

UpdateMemberRoleResponse

Authorization

CustomTokenAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details