# Soft-delete a device

**DELETE** `/devices/{device_id}`

## Parameters

### `device_id` (_path_, required)

Device id

- **Type:** `string`
- **Example:** `"42"`
- **Constraints:** pattern `^[1-9]\d*$`

## Responses

### 200

Deleted device snapshot

**application/json**

_Schema ref:_ `#/components/schemas/GetDeviceResponse` (GetDeviceResponse)

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string",
          "nullable": true
        },
        "serial_number": {
          "type": "string",
          "nullable": true
        },
        "rent": {
          "type": "string",
          "nullable": true
        },
        "tracking_number": {
          "type": "string",
          "nullable": true
        },
        "client_status": {
          "type": "string",
          "enum": [
            "ARCHIVED",
            "PENDING_VALIDATION",
            "IN_PREPARATION",
            "DELIVERED",
            "SHIPPED",
            "AVAILABLE",
            "IN_SERVICE",
            "IN_MAINTENANCE",
            "OUT_OF_SERVICE"
          ],
          "description": "Device progress key for display and filtering"
        },
        "type": {
          "type": "string",
          "nullable": true
        },
        "category": {
          "type": "string",
          "nullable": true
        },
        "source": {
          "type": "string",
          "nullable": true
        },
        "comment": {
          "type": "string",
          "nullable": true,
          "description": "Free-form device comment"
        },
        "characteristics": {
          "type": "object",
          "properties": {
            "screen_size": {
              "type": "string",
              "nullable": true
            },
            "graphic": {
              "type": "string",
              "nullable": true
            },
            "processor": {
              "type": "string",
              "nullable": true
            },
            "ram": {
              "type": "string",
              "nullable": true
            },
            "storage": {
              "type": "string",
              "nullable": true
            },
            "model_year": {
              "type": "string",
              "nullable": true
            },
            "connectivity": {
              "type": "string",
              "nullable": true
            },
            "keyboard_layout": {
              "type": "string",
              "nullable": true,
              "enum": [
                "FRENCH_AZERTY",
                "SPANISH_QWERTY",
                "ITALIAN_QWERTY",
                "INTERNATIONAL_ENGLISH_QWERTY",
                "GERMAN_QWERTZ",
                "PORTUGUESE_QWERTY",
                "ENGLISH_QWERTY",
                "SWISS_QWERTZ",
                "AMERICAN_ENGLISH_QWERTY",
                "CANADIAN_ENGLISH_QWERTY",
                "DUTCH_QWERTY"
              ],
              "description": "Keyboard layout for delivery pricing (maps to Fleet keyboard_layouts.type)",
              "example": "FRENCH_AZERTY"
            },
            "resolution": {
              "type": "string",
              "nullable": true
            },
            "has_microphone": {
              "type": "boolean",
              "nullable": true
            },
            "has_webcam": {
              "type": "boolean",
              "nullable": true
            },
            "noise_cancellation": {
              "type": "boolean",
              "nullable": true
            },
            "compliance": {
              "type": "array",
              "nullable": true,
              "items": {
                "type": "string"
              }
            },
            "connection_type": {
              "type": "array",
              "nullable": true,
              "items": {
                "type": "string"
              }
            },
            "has_stool": {
              "type": "boolean",
              "nullable": true
            },
            "has_video_package": {
              "type": "boolean",
              "nullable": true
            },
            "has_screen": {
              "type": "boolean",
              "nullable": true
            },
            "has_premium_tablet": {
              "type": "boolean",
              "nullable": true
            },
            "color": {
              "type": "string",
              "nullable": true
            },
            "seats_number": {
              "type": "string",
              "nullable": true
            },
            "assembly": {
              "type": "string",
              "nullable": true
            },
            "os_platform": {
              "type": "string",
              "nullable": true
            }
          },
          "required": [
            "screen_size",
            "graphic",
            "processor",
            "ram",
            "storage",
            "model_year",
            "connectivity",
            "keyboard_layout",
            "resolution",
            "has_microphone",
            "has_webcam",
            "noise_cancellation",
            "compliance",
            "connection_type",
            "has_stool",
            "has_video_package",
            "has_screen",
            "has_premium_tablet",
            "color",
            "seats_number",
            "assembly",
            "os_platform"
          ]
        },
        "mdm": {
          "type": "object",
          "nullable": true,
          "properties": {
            "id": {
              "type": "integer"
            },
            "status": {
              "type": "string",
              "enum": [
                "DRAFT",
                "SUBSCRIBED",
                "DOWNLOADED",
                "IDENTIFIED",
                "ENROLLMENT_IN_PROGRESS",
                "ENROLLED",
                "UNENROLLED",
                "DEVICE_WIPE_PENDING"
              ],
              "description": "Raw MDM enrollment status from `devices_mdm`. `DRAFT` rows are omitted by the device relation; other values match DB enum."
            },
            "local_name": {
              "type": "string",
              "nullable": true
            },
            "is_locked": {
              "type": "boolean",
              "nullable": true
            },
            "lock_date": {
              "type": "string",
              "nullable": true
            },
            "firewall_enabled": {
              "type": "boolean",
              "nullable": true
            },
            "os_updates_enabled": {
              "type": "boolean",
              "nullable": true
            },
            "is_encrypted": {
              "type": "boolean",
              "nullable": true
            },
            "screenlock_enabled": {
              "type": "boolean",
              "nullable": true
            },
            "is_compromised": {
              "type": "boolean",
              "nullable": true
            },
            "os_updates_available": {
              "type": "boolean",
              "nullable": true
            },
            "disk_encryption_profile_installed": {
              "type": "boolean",
              "nullable": true
            },
            "enrollment_date": {
              "type": "string",
              "nullable": true
            },
            "unenrollment_date": {
              "type": "string",
              "nullable": true
            },
            "download_date": {
              "type": "string",
              "nullable": true
            },
            "last_seen_date": {
              "type": "string",
              "nullable": true
            },
            "last_sync_date": {
              "type": "string",
              "nullable": true
            }
          },
          "required": [
            "id",
            "status",
            "local_name",
            "is_locked",
            "lock_date",
            "firewall_enabled",
            "os_updates_enabled",
            "is_encrypted",
            "screenlock_enabled",
            "is_compromised",
            "os_updates_available",
            "disk_encryption_profile_installed",
            "enrollment_date",
            "unenrollment_date",
            "download_date",
            "last_seen_date",
            "last_sync_date"
          ],
          "description": "MDM enrollment row when present (non-deleted, non-DRAFT); null otherwise"
        }
      },
      "required": [
        "id",
        "name",
        "serial_number",
        "rent",
        "tracking_number",
        "client_status",
        "type",
        "category",
        "source",
        "comment",
        "characteristics",
        "mdm"
      ]
    }
  },
  "required": [
    "data"
  ]
}
```

### 403

Forbidden

**application/json**

_Schema ref:_ `#/components/schemas/DeviceMutationForbiddenErrorResponse` (DeviceMutationForbiddenErrorResponse)

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "INSUFFICIENT_SCOPE",
        "DEVICE_MUTATION_FORBIDDEN"
      ]
    }
  },
  "required": [
    "error"
  ]
}
```

### 404

Not found

**application/json**

_Schema ref:_ `#/components/schemas/DeviceNotFoundErrorResponse` (DeviceNotFoundErrorResponse)

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "DEVICE_NOT_FOUND"
      ]
    }
  },
  "required": [
    "error"
  ]
}
```

## Security

```json
[
  {
    "bearerAuth": []
  }
]
```

**bearerAuth:** Bearer token using a Fleet platform API key (flt_sk_…).

---

_Generated from the OpenAPI specification for raw Markdown / tooling use._