Management API
Metadata Filtering
10min
to filter by object's metadata which is stored as json a query parameter with metadata prefix must be sent in the url here are some examples of how this filtering works filter by whole metadata value query param metadata={"key1" "value1"} response \[ "metadata" { "key1" "value1" } ] filter by string key value query param metadata key1="value1" response \[ { "metadata" { "key1" "value1" } }, { "metadata" { "key1" "value1", "key2" "value2" } } ] filter by number key value query param metadata key1=123 response \[ { "metadata" { "key1" 123 } } ] filter by array key value query param metadata key1=\[1, 2, 3] response \[ { "metadata" { "key1" \[ 1, 2, 3 ] } } ] filter by object key value query param metadata key1={"key2" "value2"} response \[ { "metadata" { "key1" { "key2" "value2" } } } ] filter by boolen key value query param metadata key1=true response \[ { "metadata" { "key1" true } } ] filter by null key value query param metadata key1=null response \[ { "metadata" { "key1" null } } ] filter by nested key value query param metadata key1 key2 key3="value3" response \[ { "metadata" { "key1" { "key2" { "key3" "value3" } } } } ] filter by array item query param metadata key1 0=1 response \[ { "metadata" { "key1" \[ 1, 2, 3 ] } } ] filter by array containing item query param metadata key1 contains=1 response \[ { "metadata" { "key1" \[ 1, 2, 3 ] } }, { "metadata" { "key1" \[ 3, 2, 1 ] } } ]