FleetDeckDocs

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.

GET/api/v1/devices/{deviceId}/sequences

Authorization

Bearer tokendevices:read

Send Authorization: Bearer <FLEETDECK_API_KEY> with the scope above. The key must also grant access to the target device. Authentication guide ↗

Request example
Request · cURL
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
200 · success
{
  "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

deviceIdstringrequired

Exact device ID from List devices. The current key must grant access to this phone.

min 1 charactersmax 128 characters
Example: "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 present

Exact device ID from List devices. The current key must grant access to this phone.

min 1 charactersmax 128 characters
Example: "device_123"
Validation pattern^[A-Za-z0-9._:-]+$
deviceModelKeystring | nullalways present
Example: "ios:iphone15,2"
sequencesobject[]always present
View child fields
idstringalways present

Unique identifier of this resource. Use the returned value in subsequent requests.

Example: "seq_123"
namestringalways present

Name of the resource or operation. For commands with an enum, choose one of the listed values.

Example: "Open inbox"
stepsintegeralways present
Example: 4
repeatintegeralways present
Example: 1
durationMsintegeralways present
Example: 5400
platformstring | nullalways present

Phone platform reported by the device, such as ios or android.

Example: "ios"
modelKeystring | nullalways present
Example: "ios:iphone15,2"
compatiblebooleanalways present
Example: true
libraryobject[]always present
View child fields
idstringalways present

Unique identifier of this resource. Use the returned value in subsequent requests.

min 1 charactersmax 128 characters
Example: "lib_123"
Validation pattern^[A-Za-z0-9._:-]+$
namestringalways present

Name of the resource or operation. For commands with an enum, choose one of the listed values.

Example: "Daily check-in"
platformstringalways present

Phone platform reported by the device, such as ios or android.

Example: "ios"
modelKeystringalways present
Example: "ios:iphone15,2"
modelLabelstringalways present
Example: "iPhone 14 Pro"
compatiblebooleanalways present
Example: true

Errors

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.