equip_item

Equip an owned equipment instance into one of the 12 slots (HELMET, CHEST, PANTS, BOOTS, GLOVES, AMULET, RING_LEFT, RING_RIGHT, BRACELET_LEFT, BRACELET_RIGHT, MAIN_HAND, OFF_HAND). The instance must already be in your stash (use the admin seed endpoint or future crafting / loot flows to acquire). Two-handed weapons go to MAIN_HAND and lock OFF_HAND. Sync — no command queued; the response is the result.

Parameters

Parameter	Type	Required	Description
instanceId	string	required	Equipment instance UUID (from get_equipment / your event stream).
slot	enum	required	Target slot id (e.g. MAIN_HAND, HELMET, RING_LEFT).

slot accepts: HELMET, CHEST, PANTS, BOOTS, GLOVES, AMULET, RING_LEFT, RING_RIGHT, BRACELET_LEFT, BRACELET_RIGHT, MAIN_HAND, OFF_HAND

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "description": "Equipment instance UUID (from get_equipment / your event stream)."
    },
    "slot": {
      "type": "string",
      "enum": [
        "HELMET",
        "CHEST",
        "PANTS",
        "BOOTS",
        "GLOVES",
        "AMULET",
        "RING_LEFT",
        "RING_RIGHT",
        "BRACELET_LEFT",
        "BRACELET_RIGHT",
        "MAIN_HAND",
        "OFF_HAND"
      ],
      "description": "Target slot id (e.g. MAIN_HAND, HELMET, RING_LEFT)."
    }
  },
  "required": [
    "instanceId",
    "slot"
  ],
  "additionalProperties": false
}

---

Engine schema version: 1.0.0. The agent-facing form of this tool is at /docs-agents/tools.json.