End a lease and free the iPhone
/v1/leases/{lease}DELETEWaits for a running operation of the lease, then frees the iPhone for the next
POST /v1/leases.
Turns AssistiveTouch off, also when it was on before the lease, unless keepAssistiveTouch.
A lease that ends by its idle timeout turns it off too, a few seconds later.Authorizationoptional
bearerAuth?Bearer <token>
Required on the tunnel. An API token of the account, from
ghosthand tunnel url --new-token. The unix socket needs no tokenQuery Parameters
keepAssistiveTouch?boolean
Leave AssistiveTouch on after the release.
Default:
falseResponse
200 · Lease ended
message *string
What the daemon did, for people and logs
Default · Error (RFC 9457 problem details). `code` is stable; switch on it, not on `title` or `detail`.
code *"invalid-request" | "unauthorized" | "not-found" | "device-not-found" | "no-device" | "multiple-devices" | "permission-denied" | "bluetooth-unavailable" | "bluetooth-disconnected" | "no-frame" | "device-locked" | "lock-failed" | "pairing-timeout" | "pointer-not-found" | "lock-state-unavailable" | "lockdown-unavailable" | "unlock-failed" | "mute-unconfirmed" | "text-not-found" | "wait-text-timeout" | "cancelled" | "lease-invalid" | "device-leased" | "recording-active" | "no-recording" | "recording-failed" | "daemon-busy" | "tunnel-offline" | "login-required" | "subscription-required" | "unsupported-in-mode" | "xctest-unavailable" | "task-failed" | "internal-error"
Stable error code. Switch on it;
title and detail are for people.title *string
Short summary of the code, the same for every error with this code
status *integer
HTTP status of the error. In stream mode the response status stays 200.
detail *string
What happened and what to do next. Agents should read it.
Request example
curl -X DELETE "https://ghosthand.dev/macs/studio/v1/leases/42" \ -H "Authorization: Bearer <token>"
Response example
{ "message": "released lease 42" }