api.md

Shared Types

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

Agents

Types:

from mobilerun_sdk.types import AgentListResponse

Methods:

• client.agents.list() -> AgentListResponse

Apps

Types:

from mobilerun_sdk.types import (
    AppRetrieveResponse,
    AppListResponse,
    AppDeleteResponse,
    AppConfirmUploadResponse,
    AppCreateSignedUploadURLResponse,
    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.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.update(package_name, *, device_id) -> None
• 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

Esim

Types:

from mobilerun_sdk.types.devices import EsimListResponse, EsimActivateResponse, EsimStatusResponse

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
• client.devices.esim.set_roaming(device_id, **params) -> None
• client.devices.esim.status(device_id) -> Optional[EsimStatusResponse]

Apn

Types:

from mobilerun_sdk.types.devices.esim import ApnListResponse

Methods:

• client.devices.esim.apn.create(device_id, **params) -> None
• client.devices.esim.apn.list(device_id) -> Optional[ApnListResponse]
• client.devices.esim.apn.select(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 (
    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,
    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.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,
)

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

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