.. AUTO-GENERATED FILE. DO NOT EDIT.

DELETE /hardware-toolbox-items-delete-one
=========================================

Summary
-------

- **Source repository:** ``jef-systems/jef-hardware-backend``
- **Source SHA:** ``6ac938b7e503be30e03e38baab28bb13a1f11727``
- **Source run id:** ``28330675689``
- **Lambda function:** ``jef-hardware-delete-005``
- **Lambda ARN:** ``arn:aws:lambda:ap-southeast-1:246715082475:function:jef-hardware-delete-005``
- **HTTP method:** ``DELETE``
- **Operation:** ``delete-one``
- **API path:** ``/hardware-toolbox-items-delete-one``
- **Endpoint URL:** ``https://9ulw52hih0.execute-api.ap-southeast-1.amazonaws.com/prod/hardware-toolbox-items-delete-one``
- **API Gateway REST API ID:** ``9ulw52hih0``
- **API Gateway resource ID:** ``ep8bhw``
- **API Gateway source ARN:** ``arn:aws:execute-api:ap-southeast-1:246715082475:9ulw52hih0/\*/DELETE/hardware-toolbox-items-delete-one``
- **Stage:** ``prod``
- **DynamoDB table:** ``jef-hardware-toolbox-items``
- **Primary key:** ``toolbox\_item\_id``

Primary Key Input
-----------------

The generated DELETE Lambda accepts the primary key from query parameters, path parameters, or JSON body.

Accepted aliases:

- ``toolbox\_item\_id``
- ``primary\_key\_value``
- ``id``

Query Example
-------------

.. code-block:: text

   DELETE /hardware-toolbox-items-delete-one?primary_key_value=00000000-0000-4000-8000-000000000000

JSON Body Example
-----------------

.. code-block:: json

   {
     "primary_key_value": "00000000-0000-4000-8000-000000000000"
   }

CMD curl
--------

.. code-block:: bat

   curl -X DELETE "https://9ulw52hih0.execute-api.ap-southeast-1.amazonaws.com/prod/hardware-toolbox-items-delete-one" -H "Content-Type: application/json" -d '{"primary_key_value": "00000000-0000-4000-8000-000000000000"}'

PowerShell curl
---------------

.. code-block:: powershell

   curl.exe -X DELETE "https://9ulw52hih0.execute-api.ap-southeast-1.amazonaws.com/prod/hardware-toolbox-items-delete-one" -H "Content-Type: application/json" -d "{\"primary_key_value\": \"00000000-0000-4000-8000-000000000000\"}"

Expected Responses
------------------

.. list-table::
   :header-rows: 1
   :widths: 15 85

   * - Status
     - Meaning
   * - 200
     - Item deleted.
   * - 400
     - Missing primary key, invalid payload, or cascade delete attempted.
   * - 404
     - Item not found.
   * - 409
     - Delete blocked because child records exist.
   * - 405
     - Wrong HTTP method.
   * - 500
     - Unexpected error.