> ## Documentation Index
> Fetch the complete documentation index at: https://threatbasis.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Decommission Imperial Asset

> Removes an Imperial asset from active service records

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

## 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

```json theme={null}
{
  "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

```json theme={null}
{
  "status": "error",
  "message": "Asset not found or insufficient clearance",
  "error_code": "ASSET_ACCESS_DENIED"
}
```

<Warning>
  Asset decommissioning requires Level 7 Imperial clearance or higher.
  Unauthorized attempts will be logged.
</Warning>


## OpenAPI

````yaml DELETE /assets/{asset_id}
openapi: 3.1.0
info:
  title: Imperial Command API
  description: >-
    A classified API system for managing Imperial resources, personnel, and
    operations. Access restricted to authorized Imperial personnel only.
  license:
    name: Imperial License
  version: 1.0.0-alpha
  contact:
    name: Imperial Technical Support
    email: tech-support@empire.gov
servers:
  - url: https://api.empire.gov/v1
    description: Imperial Command Center - Primary Server
  - url: https://api-backup.empire.gov/v1
    description: Imperial Command Center - Backup Server
security:
  - imperialAuth: []
tags:
  - name: Fleet Management
    description: Operations related to Imperial Navy vessels
  - name: Personnel Management
    description: Imperial personnel and Stormtrooper operations
  - name: Asset Management
    description: Imperial equipment and vehicle management
  - name: Intelligence Alerts
    description: Real-time security and intelligence notifications
paths:
  /assets/{asset_id}:
    delete:
      tags:
        - Asset Management
      summary: Decommission Imperial Asset
      description: Removes an Imperial asset from active service records
      parameters:
        - name: asset_id
          in: path
          description: Unique identifier of the asset to decommission
          required: true
          schema:
            type: string
            pattern: ^[A-Z]{3}-[0-9]{4}$
            example: TIE-7742
      requestBody:
        description: Decommission details
        content:
          application/json:
            schema:
              type: object
              properties:
                reason:
                  type: string
                  description: Reason for decommissioning
                authorized_by:
                  type: string
                  description: Imperial officer authorizing the decommission
              required:
                - reason
                - authorized_by
      responses:
        '200':
          description: Asset decommissioned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  message:
                    type: string
                    example: Asset decommissioned successfully
                  data:
                    $ref: '#/components/schemas/DecommissionedAsset'
        '403':
          description: Insufficient clearance for asset decommission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Asset not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    DecommissionedAsset:
      type: object
      properties:
        asset_id:
          type: string
          example: TIE-7742
        asset_type:
          type: string
          example: TIE Fighter
        former_pilot:
          type: string
          example: TK-421
        decommission_reason:
          type: string
          example: Combat damage - beyond repair
        decommissioned_at:
          type: string
          format: date-time
        authorized_by:
          type: string
          example: Commander Vader
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
          format: int32
          description: Imperial error code
        message:
          type: string
          description: Error description
        error_code:
          type: string
          description: Imperial system error identifier
          example: ASSET_ACCESS_DENIED
  securitySchemes:
    imperialAuth:
      type: http
      scheme: bearer
      description: >-
        Imperial Command authorisation token. Contact your commanding officer
        for access credentials.

````