REST API
API reference
HTTPS JSON endpoints for devices, sessions, actions, scheduled jobs, worker leases, native bridges and dashboard keys.
Base URL
text
https://fleetdeck.co/api/v1Dashboard key-management endpoints live at /api/agent-keys and use the signed-in browser session instead of Bearer authentication.
Response envelope
Success responses are JSON. API errors use {"error":"message","code":"CODE","issues":[]}. The client preserves error, code, numeric status, validation issues and retryAfterSeconds. HTTP 200 action records can still have failed, unknown or cancelled status.
Endpoints
GET /api/v1/devicesList assigned devicesGET /api/v1/devices/{deviceId}/capabilitiesDiscover device capabilitiesPOST /api/v1/sessionsAcquire a phone sessionDELETE /api/v1/sessions/{sessionId}Release a sessionPOST /api/v1/sessions/{sessionId}/heartbeatRenew a sessionPOST /api/v1/sessions/{sessionId}/actionsSubmit one commandGET /api/v1/sessions/{sessionId}/actions/{requestId}Read action status without replayGET /api/v1/meCheck this keyGET /api/v1/devices/{deviceId}/sequencesList saved touch sequencesPOST /api/v1/devices/{deviceId}/sequence-runsRun a saved sequence nowGET /api/v1/devices/{deviceId}/touch-schedulesList touch schedulesPOST /api/v1/devices/{deviceId}/touch-schedulesCreate a touch schedulePOST /api/v1/devices/{deviceId}/touch-schedules/{scheduleId}Pause, resume or move a touch scheduleDELETE /api/v1/devices/{deviceId}/touch-schedules/{scheduleId}Delete a touch scheduleGET /api/v1/devices/{deviceId}/touch-runsList touch runsGET /api/v1/jobsList this key’s jobsPOST /api/v1/jobsSchedule one agent taskDELETE /api/v1/jobs/{jobId}Request job cancellationPOST /api/v1/worker/jobs/claimClaim a due taskPOST /api/v1/worker/jobs/{jobId}/heartbeatRenew job authorizationPOST /api/v1/worker/jobs/{jobId}/completeRecord the agent process outcomePOST /api/v1/worker/bridge/claimRegister a bridge and claim one actionPOST /api/v1/worker/bridge/{actionId}/completeRecord a native action outcomeGET /api/agent-keysList signed-in user’s keysPOST /api/agent-keysCreate a scoped keyDELETE /api/agent-keys/{keyId}Revoke a key or purge its recordsMachine-readable contract
Download the OpenAPI specification. Runtime cross-field validation, particularly media chunk byte relationships, can be stricter than the generated schema. The prose reference calls those rules out explicitly.
