---
agentTools:
  projectIndex: https://somnio.readme.io/llms.txt
---

# Delete an Item

The `/v1/item/{id}` route provides a comprehensive interface for fetching, updating, and deleting a specified item within a Metafuse project. Here’s a breakdown of the operations available on this route:

- **GET Method:**
  Retrieves the details of a specified item.
  - `id` (required, path): Identifies the item to fetch.
  A successful query returns a `200` status code along with the item's details, while a `400` status code denotes client-side errors like missing required parameters or incorrect query format.

- **PUT Method:**
  Updates the specified item’s details with the provided JSON payload adhering to the schema (`MetafuApiDe7EW7DQuJtCln`). The schema includes:
  - `image` (optional): A base64 encoded string representing the updated image of the item.
  - `allowDuplicatesOverride` (optional): A boolean flag to control the allowance of duplicate items, defaulted to `false`.
  - `traits` (optional): An array of objects representing updated trait values and types.
  - `visibility` (optional): A string value of either `PUBLIC` or `PRIVATE` determining the visibility of the item's image and metadata.
  - `id` (required, path): Identifies the item to update.
  A successful update returns a `200` status code, indicating the successful modification of the item. A `400` status code is returned for client-side errors like missing required parameters or incorrect data format.

- **DELETE Method:**
  Deletes the specified item from the Metafuse platform.
  - `id` (required, path): Identifies the item to delete.
  A successful deletion returns a `200` status code, indicating the successful removal of the item. A `400` status code is returned for client-side errors like missing required parameters.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Metafuse Gateway",
    "description": "This API is a comprehensive service designed to enable smooth interaction with our asset management system. This includes operations at the project, item, and layer levels, catering to a wide array of functionalities ranging from image uploading to specific attribute modifications. It's particularly crafted for handling digital assets, especially images, providing users with the flexibility to manage their resources efficiently.",
    "version": "2023-06-20T18:00:42Z"
  },
  "servers": [
    {
      "url": "https://gateway.metafuse.me"
    }
  ],
  "paths": {
    "/v1/item/{id}": {
      "summary": "Manage Item Details",
      "description": "The `/v1/item/{id}` route provides a comprehensive interface for fetching, updating, and deleting a specified item within a Metafuse project. Here’s a breakdown of the operations available on this route:\n\n- **GET Method:**\n  Retrieves the details of a specified item.\n  - `id` (required, path): Identifies the item to fetch.\n  A successful query returns a `200` status code along with the item's details, while a `400` status code denotes client-side errors like missing required parameters or incorrect query format.\n\n- **PUT Method:**\n  Updates the specified item’s details with the provided JSON payload adhering to the schema (`MetafuApiDe7EW7DQuJtCln`). The schema includes:\n  - `image` (optional): A base64 encoded string representing the updated image of the item.\n  - `allowDuplicatesOverride` (optional): A boolean flag to control the allowance of duplicate items, defaulted to `false`.\n  - `traits` (optional): An array of objects representing updated trait values and types.\n  - `visibility` (optional): A string value of either `PUBLIC` or `PRIVATE` determining the visibility of the item's image and metadata.\n  - `id` (required, path): Identifies the item to update.\n  A successful update returns a `200` status code, indicating the successful modification of the item. A `400` status code is returned for client-side errors like missing required parameters or incorrect data format.\n\n- **DELETE Method:**\n  Deletes the specified item from the Metafuse platform.\n  - `id` (required, path): Identifies the item to delete.\n  A successful deletion returns a `200` status code, indicating the successful removal of the item. A `400` status code is returned for client-side errors like missing required parameters.\n",
      "delete": {
        "parameters": [
          {
            "name": "id",
            "description": "The Item to delete.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200 response",
            "content": {}
          },
          "400": {
            "description": "400 response",
            "content": {}
          }
        },
        "security": [
          {
            "MetafuseDeveloperApiStackRequestAuthorizer1C886840": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "MetafuseDeveloperApiStackRequestAuthorizer1C886840": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-amazon-apigateway-authtype": "custom"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 100,
      "1": 144,
      "2": 178,
      "3": 32,
      "4": 71,
      "5": 34,
      "6": 16,
      "7": 7,
      "8": 88,
      "9": 94,
      "10": 157,
      "11": 150
    }
  }
}
```