# claim_devices

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

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

| | |
|---|---|
| REST operation | [`createLease`](/reference/rest/leases/#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

```text
claim_devices({})
```