Setmetadata

Sets metadata on an Item

This action requires a request with an active account.

Tokens

This action requires the following tokens:

  • item-write

Arguments

Required arguments are marked in bold, and optional arguments are marked in italics.

Argument Type Default Description
item Hash   The ID of the item to set metadata on
key String   The name of the MetadataKey to set
value String  

The value to set the MetadataKey to. A null value unsets the MetadataKey

This argument can be unset by providing an empty string

Output

This action produces no output on success.

Errors

This action can return one of the default status codes, or one of the following status codes on error:

STATUS_ITEM_NOT_FOUND (120)
If the item specified by “item” can not be found
STATUS_METADATA_KEY_NOT_FOUND (470)
If the MetadataKey specified by “key” can not be found in the current Account