API reference / Jobs
List this key’s jobs
Returns up to 100 jobs, newest scheduledAt first.
/api/v1/jobsAuthorization
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/jobs' \
--header "Authorization: Bearer $FLEETDECK_API_KEY"Replace example IDs with returned values. Read credentials from your private environment.
Response examples
{
"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 presentUp to 100 jobs belonging to the current key.
View child fields
idstringalways presentUnique identifier of this resource. Use the returned value in subsequent requests.
"job_123"Validation pattern
^[A-Za-z0-9._:-]+$deviceIdstringalways presentExact device ID from List devices. The current key must grant access to this phone.
"device_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.
"Inspect phone"scheduledAtstringalways presentFuture execution instant with an explicit UTC offset. Replace example timestamps with your intended schedule.
"2030-01-01T10:00:00.000Z"timezonestringalways presentIANA timezone metadata. scheduledAt remains the authoritative execution instant.
"Europe/Bratislava"statusstringalways presentCurrent state. A completed action means the driver finished; verify the intended screen or app effect separately.
"queued""running""completed""failed""cancelled""missed""interrupted"startedAtstring | nullalways presentUTC instant execution began, or null if it has not begun.
finishedAtstring | nullalways presentUTC instant execution ended, or null while no terminal outcome is recorded.
cancelRequestedbooleanalways presentWhether cancellation has been requested. Physical effects already delivered are not undone.
falsesummarystring | nullalways presentWorker'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.
