Skip to main content
DELETE
/
assets
/
{asset_id}
Decommission Imperial Asset
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 authorisation token. Contact your commanding officer for access credentials.

Path Parameters

​
asset_id
string
required

Unique identifier of the asset to decommission

Pattern: ^[A-Z]{3}-[0-9]{4}$
Example:

"TIE-7742"

Body

application/json

Decommission details

​
reason
string
required

Reason for decommissioning

​
authorized_by
string
required

Imperial officer authorizing the decommission

Response

Asset decommissioned successfully

​
status
string
Example:

"success"

​
message
string
Example:

"Asset decommissioned successfully"

​
data
object