claim_devices

Claim devices so no other agent uses them; pass the returned lease to later calls.

REST operation	createLease (POST /v1/leases)
Needs a device	no
Read only	no
Profiles	core, testing, full

Parameters

Name	Required	Type	Goes to	What it is
device_ids	no	array of string	body deviceIds
selector	no	object	body selector
ttl_seconds	no	integer	body ttlSeconds
wait_ms	no	integer	body waitMs	How long to wait in line for a busy device, up to 60 minutes. A team phone on another Mac waits in that Mac’s line, with the people there.
task	no	string	body task	What you work on, in a few words (“Checkout test”). A team phone’s Mac shows it with your name.

Example call

claim_devices({})