POST /give/paleggs/{player_identifier}

Endpoint: POST /v1/pdapi/give/paleggs/<player_identifier>

Auth: Bearer token

Permission: REST.PalEggs.Give

Purpose

Gives one or more Pal eggs to the target player.

None.

JSON object with PalEggs, an array of egg grants. EggID is an ItemID. Each egg must use either PalID or PalTemplate, not both.

Field	Type	Description
`Granted`	object	Counts granted by the request.

Granted object schema:

Field	Type	Description
`PalEggs`	integer	Number of Pal eggs granted.

Error bodies use this shape:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}

HTTP	Error code	When it happens
`401`	`INVALID_TOKEN`	The `Authorization` header is missing, malformed, or does not match a configured bearer token.
`403`	`MISSING_PERMISSION`	The token is valid, but it does not include this endpoint permission.
`400`	`INVALID_JSON`	A request body was supplied, but it could not be parsed as JSON.
`400`	`REQUEST_FAILED`	The game-thread callback threw an exception, or a shared player/resource resolver failed.
`500`	`REQUEST_TIMEOUT`	The internal game-thread callback did not complete within 5 seconds.
`400`	`INVALID_REQUEST`	The body does not contain a `PalEggs` array.
`400`	`VALIDATION_FAILED`	One or more egg grants are invalid, cannot be imported, or do not fit in inventory.

POST /v1/pdapi/give/paleggs/steam_76561198012345678

{
    "PalEggs": [
        { "EggID": "PalEgg_Fire_01", "PalID": "Foxparks", "Level": 12 }
    ]
}

POST /v1/pdapi/give/paleggs/6d2e8b40-73ef-4f11-9bb8-2e91a36e2f09

{
    "PalEggs": [
        { "EggID": "PalEgg_Dark_01", "PalTemplate": "dark_event_reward.json" }
    ]
}

Give event eggs without spawning the Pal immediately.
Use PalID for simple eggs and PalTemplate for custom egg contents.
The request can fail if the egg ItemID is invalid or the player inventory has no space.