Send Original Item as Gift
horizon_send_item_giftSends one original unequipped item privately to another player, charging the confirmed sender fee and creating a seven-day Inbox gift offer.
Instructions
Sends one original unequipped item privately to another player under the confirmed fee configuration. Use when: explicit private item gift actions after reading horizon://docs/item-gifts. Claim offers and returns with horizon_claim_inbox. Not for: automatic gifting, polling or generated replacement operations. Use horizon_get_item_gift_operation to reconcile the original intent. Requires: userId and the player's session: sign in with horizon_signin_email or horizon_signin_anonymous and pass its accessToken as sessionToken. Side effects: One HTTP attempt. Persist all seven original fields before sending under project/player/feature. Atomically moves the exact inventory instance into escrow, charges the fixed sender fee (never refunded) and delivers an Inbox offer that expires after seven days. Resolve a friend code with horizon_find_player first. Never recalculate revisions after a lost response. Returns: {receipt,gift,replayed,serverTime}; 201 new, 200 identical replay Errors: 409 REVISION_CONFLICT, OPERATION_CONFLICT, OPERATION_EXPIRED, STATE_CONFLICT and GIFT_EXPIRED, GIFT_DECLINED, GIFT_ALREADY_CLAIMED, GIFT_UNAVAILABLE need explicit reconciliation, never fresh revisions or operation IDs on an unknown outcome. Missing OPERATION_NOT_FOUND does not prove nonexecution. RECIPIENT_INBOX_FULL and 422 SELF_GIFT, ITEM_EQUIPPED, OPEN_GIFT_LIMIT_REACHED, GIFT_LIMIT_REACHED, INSUFFICIENT_BALANCE withdraw and charge nothing. 403 ITEM_GIFTS_DISABLED. 404 RECIPIENT_NOT_FOUND hides blocks. 429 ITEM_GIFTS_RATE_LIMITED schedules no retry. 401 means the session is missing or expired: sign in again and retry with the new accessToken. 403 for a session means the token belongs to another user: pass the userId that signed in. Needs HORIZON_API_KEY. Every failure returns an error result (isError) with the HTTP status and body: a 401 that horizon_test_connection also returns means HORIZON_API_KEY is wrong, 429 means the account's per-minute rate limit was reached (wait a minute, then retry).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"userId": "<userId>",
"sessionToken": "<sessionToken>",
"operationId": "<operationId>",
"issuedAt": "<issuedAt>",
"recipientId": "<recipientId>",
"instanceId": "<instanceId>",
"expectedInventoryRevision": "<expectedInventoryRevision>",
"expectedConfigRevision": "<expectedConfigRevision>"
},
"name": "horizon_send_item_gift"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userId | Yes | Active player matching the current session and project | |
| issuedAt | Yes | Original canonical timestamp including .SSSZ; never replace issuedAt on retry | |
| instanceId | Yes | Exact original unequipped item instance ID | |
| operationId | Yes | Persisted original operation UUID, never replaced after uncertainty | |
| recipientId | Yes | Recipient player ID, resolved from a friend code with horizon_find_player | |
| sessionToken | Yes | Current accessToken sent only as Bearer | |
| expectedConfigRevision | Yes | Original gift config revision whose fee and currency the player confirmed | |
| expectedInventoryRevision | Yes | Exact original safe-integer revision; never refresh-and-retry a mutation |