DELETE
/
assets
/
{asset_id}
curl --request DELETE \
  --url https://api.empire.gov/v1/assets/{asset_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": "<string>",
  "authorized_by": "<string>"
}'
{
  "status": "success",
  "message": "Asset decommissioned successfully",
  "data": {
    "asset_id": "TIE-7742",
    "asset_type": "TIE Fighter",
    "former_pilot": "TK-421",
    "decommission_reason": "Combat damage - beyond repair",
    "decommissioned_at": "2023-11-07T05:31:56Z",
    "authorized_by": "Commander Vader"
  }
}

This endpoint is currently in development. The example below shows placeholder functionality for demonstration purposes.

​
Endpoint Overview

This endpoint will allow high-ranking Imperial officers to decommission assets from Imperial records. This could include decommissioning vehicles, equipment, or facilities. Full functionality will be available once the API is officially deployed.

Example Endpoint: DELETE /api/v1/assets/{asset_id}

​
Placeholder Request

Remove an Imperial asset from active records:

Path Parameters:

  • asset_id (string): The unique identifier of the asset to decommission

Example: DELETE /api/v1/assets/TIE-7742

​
Placeholder Response

{
  "status": "success",
  "message": "Asset decommissioned successfully",
  "data": {
    "asset_id": "TIE-7742",
    "asset_type": "TIE Fighter",
    "former_pilot": "TK-421",
    "decommission_reason": "Combat damage - beyond repair",
    "decommissioned_at": "2024-06-23T14:45:00Z",
    "authorized_by": "Commander Vader"
  }
}

​
Error Response

{
  "status": "error",
  "message": "Asset not found or insufficient clearance",
  "error_code": "ASSET_ACCESS_DENIED"
}

Asset decommissioning requires Level 7 Imperial clearance or higher. Unauthorized attempts will be logged.

Authorizations

​
Authorization
string
header
required

Imperial Command authorization token. Contact your commanding officer for access credentials.

Path Parameters

​
asset_id
string
required

Unique identifier of the asset to decommission

Example:

"TIE-7742"

Body

application/json

Decommission details

The body is of type object.

Response

200
application/json

Asset decommissioned successfully

The response is of type object.