API reference / Touch automations
List saved touch sequences
Returns sequences saved on this phone in the dashboard sequence editor (summaries, not raw coordinates) and library sequences the key owner owns or bought.
/api/v1/devices/{deviceId}/sequencesAuthorization
devices:readSend Authorization: Bearer <FLEETDECK_API_KEY> with the scope above. The key must also grant access to the target device. Authentication guide ↗
Request example
curl --request GET \
--url 'https://fleetdeck.co/api/v1/devices/device_123/sequences' \
--header "Authorization: Bearer $FLEETDECK_API_KEY"Replace example IDs with returned values. Read credentials from your private environment.
Response examples
{
"deviceId": "device_123",
"deviceModelKey": "ios:iphone15,2",
"sequences": [
{
"id": "seq_123",
"name": "Open inbox",
"steps": 4,
"repeat": 1,
"durationMs": 5400,
"platform": "ios",
"modelKey": "ios:iphone15,2",
"compatible": true
}
],
"library": [
{
"id": "lib_123",
"name": "Daily check-in",
"platform": "ios",
"modelKey": "ios:iphone15,2",
"modelLabel": "iPhone 14 Pro",
"compatible": true
}
]
}Path parameters
deviceIdstringrequiredExact device ID from List devices. The current key must grant access to this phone.
"device_123"Validation pattern
^[A-Za-z0-9._:-]+$Request body
This endpoint does not require a request body.
Behavior and limits
Returns sequences saved on this phone in the dashboard sequence editor (summaries, not raw coordinates) and library sequences the key owner owns or bought. compatible:false means the sequence was recorded on a different phone model and cannot run here. Use a sequence id with Run a saved sequence or Create a touch schedule (library:true for library ids).
Response 200
SequenceList · application/json
deviceIdstringalways presentExact device ID from List devices. The current key must grant access to this phone.
"device_123"Validation pattern
^[A-Za-z0-9._:-]+$deviceModelKeystring | nullalways present"ios:iphone15,2"sequencesobject[]always presentView child fields
idstringalways presentUnique identifier of this resource. Use the returned value in subsequent requests.
"seq_123"namestringalways presentName of the resource or operation. For commands with an enum, choose one of the listed values.
"Open inbox"stepsintegeralways present4repeatintegeralways present1durationMsintegeralways present5400platformstring | nullalways presentPhone platform reported by the device, such as ios or android.
"ios"modelKeystring | nullalways present"ios:iphone15,2"compatiblebooleanalways presenttruelibraryobject[]always presentView child fields
idstringalways presentUnique identifier of this resource. Use the returned value in subsequent requests.
"lib_123"Validation pattern
^[A-Za-z0-9._:-]+$namestringalways presentName of the resource or operation. For commands with an enum, choose one of the listed values.
"Daily check-in"platformstringalways presentPhone platform reported by the device, such as ios or android.
"ios"modelKeystringalways present"ios:iphone15,2"modelLabelstringalways present"iPhone 14 Pro"compatiblebooleanalways presenttrueErrors
Expand a code for its recovery steps. Responses use error and code; validation errors also include issues.
401UNAUTHORIZEDMissing, malformed, expired or revoked credential; user verification/password state can also deny access.
Recovery: Use Authorization: Bearer with a valid scoped key. For dashboard routes, sign in. Job children require an active parent job and timely renewal.
Full error reference ↗403FORBIDDENRequired scope, device grant, account membership or worker identity is missing.
Recovery: Check the endpoint’s scopes, exact device, owning key and workerId. A different key cannot access the original key’s sessions or jobs.
Full error reference ↗404NOT_FOUNDUnknown route or resource unavailable to this caller.
Recovery: Check method/path and use returned IDs from this account/key. Do not guess IDs.
Full error reference ↗402PLAN_REQUIREDDevice account has no active entitlement.
Recovery: Restore an active device entitlement in the workspace before controlling it.
Full error reference ↗500INTERNALUnexpected service error.
Recovery: Save nonsecret request context and time for support. Query action status before repeating a mutation; never assume it did not execute.
Full error reference ↗Example error messages are illustrative. Match the code and HTTP status; do not depend on exact message wording.
