This is called when the Steam Economy Server needs to remove an asset or chunk of currency from a user and change it to an unowned state. It is up to the asset server to verify that this is a legal change to make to this asset or currency type. It should check asset ownership matches the specified owner, that the asset or currency is tradable, and that the requested amount is present.
Name | Type | Required | Description |
key | string | ✔ | This is the "Asset Server Key" that you provided in your app's Steam Economy Settings on the partner site. |
appid | uint32 | ✔ | 32bit App ID of the application associated with the assets. |
owner | uint64 | ✔ | The 64-bit Steam ID of the current owner of the asset or currency. |
contextid | uint64 | ✔ | The 64-bit ID of the context in which this asset or currency can be found. |
assetid | uint64 | | The 64-bit asset ID being removed. Either assetid or currencyid will be set to indicate which kind of object should be set to unowned. |
currencyid | uint32 | | The 32-bit currency ID being removed. Either assetid or currencyid will be set to indicate which kind of object should be set to unowned. |
amount | uint32 | | The number of the asset or currency to remove. This number will always be 1 for non-stackable assets. It will always be less or equal to the amount that the Steam Economy server believes is present for this asset/currency in this context. Defaults to 1. |
trade_start_time | uint32 | ✔ | The time the trade session responsible for this action started, expressed in seconds from Jan. 1, 1970. |
audit_action | uint32 | ✔ | A 32-bit number that specifies what kind of action is causing this asset or currency to be set unowned. |
audit_reference | uint64 | ✔ | A 64-bit number that identifies which event is action is associated with. The asset server may wish to record this number for auditing and debugging purposes. |
leave_original | bool | ✔ | If this boolean parameter is set to 1 (to indicate true), then the asset server is being asked to duplicate the item and create a new unowned item that is a copy of the asset specified. This will only be true for one-sided undos of a trade by a support agent. Defaults to 0 (false). |
request_repeated | bool | ✔ | If this is set to 1 (to indicate true), then the Steam Economy server is indicating that it has made an identical request to this one at some point in the past but did not receive a clear success or failure. If it appears that the asset or currency has already been set to Unowned for the same audit_action and audit_reference, the asset server should return success and set new_assetid and new_contextid to whatever was returned on the first request. |
is_market | bool | ✔ | If this is set to 1 (to indicate true), then the request is being performed in response to some activity on the Steam Community Market. |
The output from this method should be encoded in the JSON format.
This is the current list of audit actions that could be passed with this method. New audit types could be added to this list at any time, so asset servers should be ready to deal with any unsigned 32-bit number as an audit action.