%%
Last Updated:
- [[2021-02-13]]
%%
[The Flood API](https://docs.flood.io/) allows floods to be started using HTTP requests.
## Using the Flood API
### Sample API call to start a flood:
```bash
curl -u <token>: -X POST https://api.flood.io/api/floods \
-F "flood[tool]=flood-chrome" \
-F "flood[threads]=5" \
-F "flood[privacy]=public" \
-F "flood[project]=Element" \
-F "flood[name]=YouTube2" \
-F "flood[duration]=300" \
-F "flood_files[]=@/Users/nic/Downloads/youtube2.ts" \
-F "flood[grids][][infrastructure]=demand" \
-F "flood[grids][][instance_quantity]=1" \
-F "flood[grids][][region]=us-west-2" \
-F "flood[grids][][instance_type]=m5.xlarge" \
-F "flood[grids][][stop_after]=60"
```