1. Commands
Sety
  • Default module
    • Developer API Reference
    • Health
      • Health check
    • Incidents
      • Create incident
      • List incidents
      • Get incident
      • Cancel incident
      • Add note
    • Access Logs
      • List access logs
      • Access log stats
      • Create access log
      • Get current visitors
      • Checkout visitor
    • Threat Intelligence
      • List danger zones
      • Danger analytics for a location
      • Heatmap data
      • Safety score
      • Route safety analysis
    • Schemas
      • Error
      • PaginatedResponse
      • Subject
      • GeoPoint
      • Location
      • IncidentLocation
      • IncidentTimelineEvent
      • SLA
      • ResponderAssignment
      • TimelineEvent
      • Incident
      • CreateIncidentRequest
      • IncidentAnalytics
      • AccessCode
      • CreateAccessCodeRequest
      • ValidationResult
      • AccessLog
      • CurrentVisitor
      • DangerAnalytics
      • HeatmapResponse
      • SafetyScore
      • TimeAnalysis
      • LocationComparison
      • RouteSafety
      • RiskPrediction
      • IncidentPatterns
      • SafeZones
      • ApiKey
      • CreateApiKeyRequest
      • WebhookEndpoint
      • WebhookDelivery
  • Sety Checkpoint CP-1 – Device API
    • Sync & enrolment
      • Registration flag and pending commands
      • Report the result of a fingerprint enrolment
    • Attendance
      • Send one attendance event
      • Upload up to 100 saved events in one request
    • Commands
      • Report the outcome of each command
        POST
    • Status
      • Status report (only when Wi-Fi is already on)
    • Future
      • optional
        • Server time (fallback when NTP is blocked)
        • Check for a firmware update (placeholder)
    • Schemas
      • DeviceId
      • Uid
      • Timestamp
      • SyncResponse
      • Command
      • EnrollRequest
      • EnrollResponse
      • ScanRequest
      • ScanResponse
      • BatchRequest
      • BatchResponse
      • CommandResultsRequest
      • CommandResultsResponse
      • HeartbeatRequest
      • HeartbeatResponse
      • Error
  1. Commands

Report the outcome of each command

POST
/device/commands/result
Send after running the commands from a sync. ok: false keeps the command pending, so it comes
back on the next sync. Deleting a UID that is already gone should be reported as ok: true.
Unknown or already-finished ids are ignored.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Recorded
Bodyapplication/json

🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠404UnknownDevice
🟠429RateLimited
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/device/commands/result' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "MyDevice-A0CDCB",
    "results": [
        {
            "id": "c-1a2b3c4d5e6f",
            "ok": true
        },
        {
            "id": "c-6f5e4d3c2b1a",
            "ok": false,
            "error": "sensor_error"
        }
    ]
}'
Response Response Example
200 - Success
{
    "status": "ok",
    "processed": 2,
    "ignored": 0
}
Modified at 2026-10-07 14:49:40
Previous
Upload up to 100 saved events in one request
Next
Status report (only when Wi-Fi is already on)
Built with