POST /summon/npc

Endpoint: POST /v1/pdapi/summon/npc
Auth: Bearer token
Permission: REST.Summon.NPC

Purpose

Spawns an NPC at fixed map coordinates.

Field	Type	Required	Description
`NPCID`	string	Yes	NPC ID or NPC character ID.
`X`, `Y`, `Z`	number	Yes	Map coordinates.
`Level`	integer	No	NPC level (default `1`).
`Uncapturable`	bool	No	Prevents capture (default `false`).
`DisableAI`	bool	No	Disables normal AI (default `false`).

Field	Type	Description
`Summoned`	object	Details of the spawned NPC.

Summoned contains Type ("NPC"), NPCID, Level, Uncapturable, DisableAI, and the requested X, Y, and Z.

Alongside standard authentication/request errors, this route may return VALIDATION_FAILED or SUMMON_NPC_FAILED.

POST /v1/pdapi/summon/npc
Authorization: Bearer <token>
Content-Type: application/json

{
    "NPCID": "PIDF_Soldier_AssaultRifle",
    "Level": 30,
    "X": 230,
    "Y": -486,
    "Z": 4097
}