api.md

Shared Types

from mobilerun_sdk.types import (
    DeviceCarrier,
    DeviceIdentifiers,
    DeviceSpec,
    Location,
    Meta,
    Pagination,
    PaginationMeta,
    PermissionSet,
    Socks5,
)

Apps

Types:

from mobilerun_sdk.types import (
    AppRetrieveResponse,
    AppListResponse,
    AppDeleteResponse,
    AppConfirmUploadResponse,
    AppCreateSignedUploadURLResponse,
    AppListVersionsResponse,
    AppMarkFailedResponse,
)

Methods:

• client.apps.retrieve(id) -> AppRetrieveResponse
• client.apps.list(**params) -> AppListResponse
• client.apps.delete(id) -> AppDeleteResponse
• client.apps.confirm_upload(id) -> AppConfirmUploadResponse
• client.apps.create_signed_upload_url(**params) -> AppCreateSignedUploadURLResponse
• client.apps.list_versions(id) -> AppListVersionsResponse
• client.apps.mark_failed(id) -> AppMarkFailedResponse

Carriers

Types:

from mobilerun_sdk.types import (
    CarrierCreateResponse,
    CarrierRetrieveResponse,
    CarrierUpdateResponse,
    CarrierListResponse,
    CarrierDeleteResponse,
    CarrierLookupResponse,
)

Methods:

• client.carriers.create(**params) -> CarrierCreateResponse
• client.carriers.retrieve(carrier_id) -> CarrierRetrieveResponse
• client.carriers.update(carrier_id, **params) -> CarrierUpdateResponse
• client.carriers.list(**params) -> CarrierListResponse
• client.carriers.delete(carrier_id) -> CarrierDeleteResponse
• client.carriers.lookup(**params) -> CarrierLookupResponse

Credentials

Types:

from mobilerun_sdk.types import CredentialListResponse

Methods:

• client.credentials.list(**params) -> CredentialListResponse

Packages

Types:

from mobilerun_sdk.types.credentials import PackageCreateResponse, PackageListResponse

Methods:

• client.credentials.packages.create(**params) -> PackageCreateResponse
• client.credentials.packages.list(package_name) -> PackageListResponse

Credentials

Types:

from mobilerun_sdk.types.credentials.packages import (
    Credential,
    CredentialCreateResponse,
    CredentialRetrieveResponse,
    CredentialDeleteResponse,
)

Methods:

• client.credentials.packages.credentials.create(package_name, **params) -> CredentialCreateResponse
• client.credentials.packages.credentials.retrieve(credential_name, *, package_name) -> CredentialRetrieveResponse
• client.credentials.packages.credentials.delete(credential_name, *, package_name) -> CredentialDeleteResponse

Fields

Types:

from mobilerun_sdk.types.credentials.packages.credentials import (
    FieldCreateResponse,
    FieldUpdateResponse,
    FieldDeleteResponse,
)

Methods:

• client.credentials.packages.credentials.fields.create(credential_name, *, package_name, **params) -> FieldCreateResponse
• client.credentials.packages.credentials.fields.update(field_type, *, package_name, credential_name, **params) -> FieldUpdateResponse
• client.credentials.packages.credentials.fields.delete(field_type, *, package_name, credential_name) -> FieldDeleteResponse

Devices

Types:

from mobilerun_sdk.types import (
    Device,
    DeviceListResponse,
    DeviceCountResponse,
    DeviceFingerprintResponse,
)

Methods:

• client.devices.create(**params) -> Device
• client.devices.retrieve(device_id) -> Device
• client.devices.list(**params) -> DeviceListResponse
• client.devices.count() -> DeviceCountResponse
• client.devices.fingerprint(device_id) -> DeviceFingerprintResponse
• client.devices.reboot(device_id) -> None
• client.devices.reset(device_id) -> None
• client.devices.set_name(device_id, **params) -> Device
• client.devices.terminate(device_id, **params) -> None
• client.devices.wait_ready(device_id) -> Device

Actions

Types:

from mobilerun_sdk.types.devices import ActionOverlayVisibleResponse

Methods:

• client.devices.actions.global_(device_id, **params) -> None
• client.devices.actions.overlay_visible(device_id) -> ActionOverlayVisibleResponse
• client.devices.actions.set_overlay_visible(device_id, **params) -> None
• client.devices.actions.swipe(device_id, **params) -> None
• client.devices.actions.tap(device_id, **params) -> None

Apps

Types:

from mobilerun_sdk.types.devices import AppListResponse

Methods:

• client.devices.apps.list(device_id, **params) -> Optional[AppListResponse]
• client.devices.apps.delete(package_name, *, device_id) -> None
• client.devices.apps.install(device_id, **params) -> None
• client.devices.apps.start(package_name, *, device_id, **params) -> None
• client.devices.apps.stop(package_name, *, device_id) -> None

Esim

Types:

from mobilerun_sdk.types.devices import EsimListResponse, EsimActivateResponse

Methods:

• client.devices.esim.list(device_id) -> Optional[EsimListResponse]
• client.devices.esim.activate(device_id, **params) -> EsimActivateResponse
• client.devices.esim.enable(device_id, **params) -> None
• client.devices.esim.remove(device_id, **params) -> None

Files

Types:

from mobilerun_sdk.types.devices import FileInfo, FileListResponse, FileDownloadResponse

Methods:

• client.devices.files.list(device_id, **params) -> FileListResponse
• client.devices.files.delete(device_id, **params) -> None
• client.devices.files.download(device_id, **params) -> str
• client.devices.files.upload(device_id, **params) -> None

Keyboard

Methods:

• client.devices.keyboard.clear(device_id) -> None
• client.devices.keyboard.key(device_id, **params) -> None
• client.devices.keyboard.write(device_id, **params) -> None

Location

Methods:

• client.devices.location.get(device_id) -> Location
• client.devices.location.set(device_id, **params) -> None

Packages

Types:

from mobilerun_sdk.types.devices import PackageListResponse

Methods:

• client.devices.packages.list(device_id, **params) -> Optional[PackageListResponse]

Profile

Methods:

• client.devices.profile.update(device_id, **params) -> None

Proxy

Types:

from mobilerun_sdk.types.devices import ProxyStatusResponse

Methods:

• client.devices.proxy.connect(device_id, **params) -> None
• client.devices.proxy.disconnect(device_id) -> None
• client.devices.proxy.status(device_id) -> ProxyStatusResponse

State

Types:

from mobilerun_sdk.types.devices import (
    A11YNode,
    Rect,
    StateScreenshotResponse,
    StateTimeResponse,
    StateUiResponse,
)

Methods:

• client.devices.state.screenshot(device_id, **params) -> str
• client.devices.state.time(device_id) -> str
• client.devices.state.ui(device_id, **params) -> StateUiResponse

Tasks

Types:

from mobilerun_sdk.types.devices import TaskListResponse

Methods:

• client.devices.tasks.list(device_id, **params) -> TaskListResponse

Timezone

Types:

from mobilerun_sdk.types.devices import TimezoneGetResponse

Methods:

• client.devices.timezone.get(device_id) -> TimezoneGetResponse
• client.devices.timezone.set(device_id, **params) -> None

Language

Types:

from mobilerun_sdk.types.devices import LanguageGetResponse

Methods:

• client.devices.language.get(device_id) -> LanguageGetResponse
• client.devices.language.set(device_id, **params) -> None

Hooks

Types:

from mobilerun_sdk.types import (
    HookRetrieveResponse,
    HookUpdateResponse,
    HookListResponse,
    HookGetSampleDataResponse,
    HookPerformResponse,
    HookSubscribeResponse,
    HookTestResponse,
    HookUnsubscribeResponse,
)

Methods:

• client.hooks.retrieve(hook_id) -> HookRetrieveResponse
• client.hooks.update(hook_id, **params) -> HookUpdateResponse
• client.hooks.list(**params) -> HookListResponse
• client.hooks.get_sample_data() -> HookGetSampleDataResponse
• client.hooks.perform(**params) -> HookPerformResponse
• client.hooks.subscribe(**params) -> HookSubscribeResponse
• client.hooks.test(hook_id, **params) -> HookTestResponse
• client.hooks.unsubscribe(hook_id) -> HookUnsubscribeResponse

Models

Types:

from mobilerun_sdk.types import ModelListResponse

Methods:

• client.models.list() -> ModelListResponse

Profiles

Types:

from mobilerun_sdk.types import Profile, ProfileListResponse, ProfileDeleteResponse

Methods:

• client.profiles.create(**params) -> Profile
• client.profiles.retrieve(profile_id) -> Profile
• client.profiles.update(profile_id, **params) -> Profile
• client.profiles.list(**params) -> ProfileListResponse
• client.profiles.delete(profile_id) -> ProfileDeleteResponse

Proxies

Types:

from mobilerun_sdk.types import (
    ProxyConfig,
    ProxyCreateResponse,
    ProxyRetrieveResponse,
    ProxyUpdateResponse,
    ProxyListResponse,
    ProxyDeleteResponse,
    ProxyLookupResponse,
)

Methods:

• client.proxies.create(**params) -> ProxyCreateResponse
• client.proxies.retrieve(proxy_id) -> ProxyRetrieveResponse
• client.proxies.update(proxy_id, **params) -> ProxyUpdateResponse
• client.proxies.list(**params) -> ProxyListResponse
• client.proxies.delete(proxy_id) -> ProxyDeleteResponse
• client.proxies.lookup(**params) -> ProxyLookupResponse

Connect

Countries

Types:

from mobilerun_sdk.types.connect import CountryListResponse

Methods:

• client.connect.countries.list(**params) -> CountryListResponse

Proxies

Types:

from mobilerun_sdk.types.connect import (
    ProxyRetrieveResponse,
    ProxyListResponse,
    ProxyBuyResponse,
    ProxyListConnectionsResponse,
    ProxyPingResponse,
)

Methods:

• client.connect.proxies.retrieve(id) -> ProxyRetrieveResponse
• client.connect.proxies.list(**params) -> ProxyListResponse
• client.connect.proxies.buy(**params) -> ProxyBuyResponse
• client.connect.proxies.cancel(id) -> None
• client.connect.proxies.list_connections(id, **params) -> ProxyListConnectionsResponse
• client.connect.proxies.ping(id) -> ProxyPingResponse

Users

Types:

from mobilerun_sdk.types.connect import (
    UserCreateResponse,
    UserRetrieveResponse,
    UserUpdateResponse,
    UserListResponse,
    UserListConnectionsResponse,
)

Methods:

• client.connect.users.create(**params) -> UserCreateResponse
• client.connect.users.retrieve(id) -> UserRetrieveResponse
• client.connect.users.update(id, **params) -> UserUpdateResponse
• client.connect.users.list(**params) -> UserListResponse
• client.connect.users.delete(id) -> None
• client.connect.users.list_connections(id, **params) -> UserListConnectionsResponse

Tasks

Types:

from mobilerun_sdk.types import (
    PackageCredentials,
    Task,
    TaskStatus,
    UsageResult,
    TaskRetrieveResponse,
    TaskListResponse,
    TaskGetStatusResponse,
    TaskGetTrajectoryResponse,
    TaskRunResponse,
    TaskSendMessageResponse,
    TaskStopResponse,
)

Methods:

• client.tasks.retrieve(task_id) -> TaskRetrieveResponse
• client.tasks.list(**params) -> TaskListResponse
• client.tasks.attach(task_id) -> None
• client.tasks.get_status(task_id) -> TaskGetStatusResponse
• client.tasks.get_trajectory(task_id) -> TaskGetTrajectoryResponse
• client.tasks.run(**params) -> TaskRunResponse
• client.tasks.run_streamed(**params) -> object
• client.tasks.send_message(task_id, **params) -> TaskSendMessageResponse
• client.tasks.stop(task_id) -> TaskStopResponse

Screenshots

Types:

from mobilerun_sdk.types.tasks import MediaResponse, ScreenshotListResponse

Methods:

• client.tasks.screenshots.retrieve(index, *, task_id) -> MediaResponse
• client.tasks.screenshots.list(task_id) -> ScreenshotListResponse

UiStates

Types:

from mobilerun_sdk.types.tasks import UiStateListResponse

Methods:

• client.tasks.ui_states.retrieve(index, *, task_id) -> MediaResponse
• client.tasks.ui_states.list(task_id) -> UiStateListResponse

Workflows

Types:

from mobilerun_sdk.types import Flow

Triggers

Types:

from mobilerun_sdk.types.workflows import (
    TriggerCreateResponse,
    TriggerRetrieveResponse,
    TriggerUpdateResponse,
    TriggerListResponse,
    TriggerDeleteResponse,
    TriggerFireResponse,
)

Methods:

• client.workflows.triggers.create(**params) -> TriggerCreateResponse
• client.workflows.triggers.retrieve(trigger_id) -> TriggerRetrieveResponse
• client.workflows.triggers.update(trigger_id, **params) -> TriggerUpdateResponse
• client.workflows.triggers.list(**params) -> TriggerListResponse
• client.workflows.triggers.delete(trigger_id) -> TriggerDeleteResponse
• client.workflows.triggers.fire(trigger_id, **params) -> TriggerFireResponse

ActionCatalog

Types:

from mobilerun_sdk.types.workflows import (
    ActionCatalogEntry,
    ActionCatalogRetrieveResponse,
    ActionCatalogListResponse,
)

Methods:

• client.workflows.action_catalog.retrieve(catalog_entry_id) -> ActionCatalogRetrieveResponse
• client.workflows.action_catalog.list(**params) -> ActionCatalogListResponse

Actions

Types:

from mobilerun_sdk.types.workflows import (
    Action,
    ActionCreateResponse,
    ActionRetrieveResponse,
    ActionUpdateResponse,
    ActionListResponse,
    ActionDeleteResponse,
)

Methods:

• client.workflows.actions.create(**params) -> ActionCreateResponse
• client.workflows.actions.retrieve(action_id) -> ActionRetrieveResponse
• client.workflows.actions.update(action_id, **params) -> ActionUpdateResponse
• client.workflows.actions.list(**params) -> ActionListResponse
• client.workflows.actions.delete(action_id) -> ActionDeleteResponse

Services

Types:

from mobilerun_sdk.types.workflows.actions import ServiceListResponse, ServiceListMethodsResponse

Methods:

• client.workflows.actions.services.list() -> ServiceListResponse
• client.workflows.actions.services.list_methods(service) -> ServiceListMethodsResponse

Flows

Types:

from mobilerun_sdk.types.workflows import (
    FlowActionOverrides,
    FlowChildActionInput,
    FlowCreateResponse,
    FlowRetrieveResponse,
    FlowUpdateResponse,
    FlowListResponse,
    FlowDeleteResponse,
    FlowCloneResponse,
    FlowUnblockResponse,
)

Methods:

• client.workflows.flows.create(**params) -> FlowCreateResponse
• client.workflows.flows.retrieve(flow_id) -> FlowRetrieveResponse
• client.workflows.flows.update(flow_id, **params) -> FlowUpdateResponse
• client.workflows.flows.list(**params) -> FlowListResponse
• client.workflows.flows.delete(flow_id) -> FlowDeleteResponse
• client.workflows.flows.clone(flow_id, **params) -> FlowCloneResponse
• client.workflows.flows.unblock(flow_id) -> FlowUnblockResponse

Actions

Types:

from mobilerun_sdk.types.workflows.flows import (
    FlowAction,
    ActionListResponse,
    ActionAddResponse,
    ActionRemoveResponse,
    ActionReplaceResponse,
)

Methods:

• client.workflows.flows.actions.list(flow_id) -> ActionListResponse
• client.workflows.flows.actions.add(flow_id, **params) -> ActionAddResponse
• client.workflows.flows.actions.remove(flow_action_id, *, flow_id) -> ActionRemoveResponse
• client.workflows.flows.actions.replace(flow_id, **params) -> ActionReplaceResponse

Events

Types:

from mobilerun_sdk.types.workflows import EventDryRunResponse, EventIngestResponse

Methods:

• client.workflows.events.dry_run(**params) -> EventDryRunResponse
• client.workflows.events.ingest(**params) -> EventIngestResponse

Catalog

Types:

from mobilerun_sdk.types.workflows.events import CatalogListResponse, CatalogRegisterResponse

Methods:

• client.workflows.events.catalog.list(**params) -> CatalogListResponse
• client.workflows.events.catalog.register(**params) -> CatalogRegisterResponse

Executions

Types:

from mobilerun_sdk.types.workflows import (
    FlowExecution,
    ExecutionRetrieveResponse,
    ExecutionListResponse,
    ExecutionGetMetricsResponse,
)

Methods:

• client.workflows.executions.retrieve(execution_id) -> ExecutionRetrieveResponse
• client.workflows.executions.list(**params) -> ExecutionListResponse
• client.workflows.executions.get_metrics(**params) -> ExecutionGetMetricsResponse

Timezones

Types:

from mobilerun_sdk.types.workflows import TimezoneListResponse

Methods:

• client.workflows.timezones.list() -> TimezoneListResponse

Secrets

Types:

from mobilerun_sdk.types.workflows import (
    UserSecret,
    SecretCreateResponse,
    SecretListResponse,
    SecretDeleteResponse,
)

Methods:

• client.workflows.secrets.create(**params) -> SecretCreateResponse
• client.workflows.secrets.list() -> SecretListResponse
• client.workflows.secrets.delete(secret_id) -> SecretDeleteResponse

Webhooks

Types:

from mobilerun_sdk.types import (
    WebhookCreateResponse,
    WebhookRetrieveResponse,
    WebhookUpdateResponse,
    WebhookListResponse,
    WebhookEventTypesResponse,
    WebhookRotateSecretResponse,
    WebhookTestDeliveryResponse,
)

Methods:

• client.webhooks.create(**params) -> WebhookCreateResponse
• client.webhooks.retrieve(id) -> WebhookRetrieveResponse
• client.webhooks.update(id, **params) -> WebhookUpdateResponse
• client.webhooks.list(**params) -> WebhookListResponse
• client.webhooks.delete(id) -> None
• client.webhooks.event_types() -> WebhookEventTypesResponse
• client.webhooks.rotate_secret(id) -> WebhookRotateSecretResponse
• client.webhooks.test_delivery(id) -> WebhookTestDeliveryResponse

Deliveries

Types:

from mobilerun_sdk.types.webhooks import (
    DeliveryListResponse,
    DeliveryListForWebhookResponse,
    DeliveryRetrieveAttemptsResponse,
    DeliveryStatsResponse,
)

Methods:

• client.webhooks.deliveries.list(**params) -> DeliveryListResponse
• client.webhooks.deliveries.list_for_webhook(id, **params) -> DeliveryListForWebhookResponse
• client.webhooks.deliveries.retrieve_attempts(delivery_id, *, id) -> DeliveryRetrieveAttemptsResponse
• client.webhooks.deliveries.stats(**params) -> DeliveryStatsResponse