FleetDeckDocs

API reference / Jobs

List this key’s jobs

Returns up to 100 jobs, newest scheduledAt first.

GET/api/v1/jobs

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/jobs' \
  --header "Authorization: Bearer $FLEETDECK_API_KEY"

Replace example IDs with returned values. Read credentials from your private environment.

Response examples
200 · success
{
  "jobs": [
    {
      "id": "job_123",
      "deviceId": "device_123",
      "name": "Inspect phone",
      "scheduledAt": "2030-01-01T10:00:00.000Z",
      "timezone": "Europe/Bratislava",
      "status": "queued",
      "startedAt": null,
      "finishedAt": null,
      "cancelRequested": false,
      "summary": null
    }
  ]
}

Request body

This endpoint does not require a request body.

Behavior and limits

Returns up to 100 jobs, newest scheduledAt first. Jobs are key-owned; another key for the same account cannot list them. There is no pagination cursor or individual job GET endpoint. Prompts and child tokens are not returned.

Response 200

JobList · application/json

jobsobject[]always present

Up to 100 jobs belonging to the current key.

View child fields
idstringalways present

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

min 1 charactersmax 128 characters
Example: "job_123"
Validation pattern^[A-Za-z0-9._:-]+$
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._:-]+$
namestringalways present

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

Example: "Inspect phone"
scheduledAtstringalways present

Future execution instant with an explicit UTC offset. Replace example timestamps with your intended schedule.

date-time
Example: "2030-01-01T10:00:00.000Z"
timezonestringalways present

IANA timezone metadata. scheduledAt remains the authoritative execution instant.

Example: "Europe/Bratislava"
statusstringalways present

Current state. A completed action means the driver finished; verify the intended screen or app effect separately.

Allowed:"queued""running""completed""failed""cancelled""missed""interrupted"
startedAtstring | nullalways present

UTC instant execution began, or null if it has not begun.

date-time
finishedAtstring | nullalways present

UTC instant execution ended, or null while no terminal outcome is recorded.

date-time
cancelRequestedbooleanalways present

Whether cancellation has been requested. Physical effects already delivered are not undone.

Example: false
summarystring | nullalways present

Worker's completion summary. It describes the process outcome, not independently verified app success.

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 ↗
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.