Resource-reference IDs limited to 32 characters
What's new
Request properties that reference another resource by ID now enforce a 32-character maximum length. The constraint was added across catalog, campaign, page, store item, and store promotion endpoints, covering fields such as item_id, price_template_id, rarity_id, parent_id, virtual_currency_id, payment_method_ids, and related identifiers.
Impact
Requests that send an ID longer than 32 characters for these fields will now be rejected by validation. Aghanim resource IDs are already 32 characters, so callers passing valid IDs are unaffected.
Changes
| Resource | Change |
|---|---|
| create_campaign, update_campaign, update_campaign_graph | Reward-settings virtual_currency_id request field capped at 32 characters |
| create_daily_reward, update_daily_reward | Reward item id request fields capped at 32 characters |
| create_item_category, update_item_category, bulk_update_item_categories, bulk_delete_item_categories | id, item_template_id, and parent_id request fields capped at 32 characters |
| create_item, update_item, bulk_create_or_update_items, bulk_update_items, bulk_delete_items | id, fallback_item_id, price_template_id, rarity_id, and nested item id request fields capped at 32 characters |
| create_page, update_page, bulk_update_page | Dynamic block graph-rule virtual_currency_id request field capped at 32 characters |
| update_segment_group | Graph reward virtual_currency_id request field capped at 32 characters |
| create_store_item, update_store_item, bulk_update_store_items, batch_create_store_item | item_id, campaign_id, bonus_item_id, price_template_id, virtual_currency_id, payment_method_ids, and related ID request fields capped at 32 characters |
| create_store_promotion, update_store_promotion, bulk_update_store_promotions | Reward-settings virtual_currency_id request field capped at 32 characters |
Upgrade
- No action required if you send standard Aghanim resource IDs. If you generate or forward IDs from another system, ensure they do not exceed 32 characters.
Need help?
Contact our integration team at [email protected]