Filters¶

Remove radio items based on some conditions

Cooldown¶

Removes all the tracks that have been recently listened.

Inputs¶

• duration: String (required): The amount of time that should pass since the last listen before allowing the track to pass.

Example¶

{
    "step_type": "cooldown_filter",
    "id": "cooldown_filter",
    "inputs": {
        "duration": "1 day 12 hours 24 minutes"
    }
}

listens¶

This filter only let tracks that have a minimum (inclusive) or maximum (inclusive) of listens.

Setting a maximum of 0 only give unlistened tracks

⚠️ Make sure the listens are loaded before this step

Inputs¶

• minimum: Int (Default: 0): The minimum amount of listens
• maximum: Int (Default: infinite): The minimum amount of listens

Example¶

{
    "step_type": "listen_filter",
    "id": "listen_filter",
    "inputs": {
        "minimum": 3 
    }
}

Timeouts¶

Removes all the tracks that the user put in timeout (using config timeout 🔗)

Inputs¶

• timeouts: Timeout: The list of track timeouts.

Example¶

{
    "step_type": "timeout_filter",
    "id": "timeout_filter",
    "inputs": {
        "timeouts": {
            "1119dec1-2ed9-49ff-a059-2bd5b048af3c": "2025-09-20T14:26:57.455793591Z",
            "7cd8da60-3255-4708-9cc0-6bfdd196fd5f": "2025-09-20T14:28:19.264683649Z",
        }
    }
}