diff --git a/API.md b/API.md
index 19ae98d85..52a6a2ad9 100644
--- a/API.md
+++ b/API.md
@@ -8,11 +8,6 @@ iD supports several URL parameters. When constructing a URL to a standalone inst
of iD (e.g. `http://preview.ideditor.com/release/`), the following parameters are available
**in the hash portion of the URL**:
-* __`map`__ - A slash separated `zoom/latitude/longitude`.
- _Example:_ `map=20.00/38.90085/-77.02271`
-* __`id`__ - The character 'n', 'w', or 'r', followed by the OSM ID of a node,
- way or relation, respectively. Selects the specified entity, and, unless
- a `map` parameter is also provided, centers the map on it.
* __`background`__ - The value from a `sourcetag` property in iD's
[imagery list](https://github.com/openstreetmap/iD/blob/master/data/imagery.json),
or a custom tile URL. A custom URL is specified in the format `custom:`,
@@ -20,6 +15,8 @@ of iD (e.g. `http://preview.ideditor.com/release/`), the following parameters ar
`{z}`/`{zoom}`, `{ty}` for flipped TMS-style Y coordinates, and `{switch:a,b,c}` for
DNS multiplexing.
_Example:_ `background=custom:https://{switch:a,b,c}.tile.openstreetmap.org/{zoom}/{x}/{y}.png`
+* __`comment`__ - Prefills the changeset comment. Pass a url encoded string.
+ _Example:_ `comment=CAR%20crisis%2C%20refugee%20areas%20in%20Cameroon`
* __`disable_features`__ - Disables features in the list.
_Example:_ `disable_features=water,service_roads,points,paths,boundaries`
_Available features:_ `points` `traffic_roads` `service_roads` `paths` `buildings` `landuse`
@@ -27,24 +24,30 @@ of iD (e.g. `http://preview.ideditor.com/release/`), the following parameters ar
* __`gpx`__ - A custom URL for loading a gpx track. Specifying a `gpx` parameter will
automatically enable the gpx layer for display.
_Example:_ `gpx=https://tasks.hotosm.org/project/592/task/16.gpx`
-* __`maprules`__ - connect to a [MapRules](https://github.com/radiant-maxar/maprules) service for enhanced tag validation.
- _Example:_ `maprules=https://path/to/file.json`
-* __`offset`__ - imagery offset in meters, formatted as `east,north`.
- _Example:_ `offset=-10,5`
-* __`presets`__ - load an external presets file.
- _Example:_ `presets=https://path/to/presets.json`
-* __`comment`__ - Prefills the changeset comment. Pass a url encoded string.
- _Example:_ `comment=CAR%20crisis%2C%20refugee%20areas%20in%20Cameroon`
-* __`source`__ - Prefills the changeset source. Pass a url encoded string.
- _Example:_ `source=Bing%3BMapillary`
* __`hashtags`__ - Prefills the changeset hashtags. Pass a url encoded list of event
hashtags separated by commas, semicolons, or spaces. Leading '#' symbols are
optional and will be added automatically. (Note that hashtag-like strings are
automatically detected in the `comment`).
_Example:_ `hashtags=%23hotosm-task-592,%23MissingMaps`
-* __`locale`__ - A code specifying the localization to use, affecting the language, layout, and keyboard shortcuts. Must be one of the [supported locales](https://github.com/openstreetmap/iD/tree/master/dist/locales). The default locale is set by the browser.
- _Example:_ `locale=en-US`, `locale=de`
+* __`id`__ - The character 'n', 'w', or 'r', followed by the OSM ID of a node, way or relation, respectively. Selects the specified entity, and, unless a `map` parameter is also provided, centers the map on it.
+ _Example:_ `id=n1207480649`
+* __`locale`__ - A code specifying the localization to use, affecting the language, layout, and keyboard shortcuts. The default locale is set by the browser.
+ _Example:_ `locale=en-US`, `locale=de`
+ _Available values:_ Any of the [supported locales](https://github.com/openstreetmap/iD/tree/master/dist/locales).
+* __`map`__ - A slash-separated `zoom/latitude/longitude`.
+ _Example:_ `map=20.00/38.90085/-77.02271`
+* __`maprules`__ - A path to a [MapRules](https://github.com/radiant-maxar/maprules) service endpoint for enhanced tag validation.
+ _Example:_ `maprules=https://path/to/file.json`
+* __`offset`__ - Background imagery alignment offset in meters, formatted as `east,north`.
+ _Example:_ `offset=-10,5`
+* __`photo_overlay`__ - The street-level photo overlay layers to enable.
+ _Example:_ `photo_overlay=streetside,mapillary,openstreetcam`
+ _Available values:_ `streetside` (Microsoft Bing), `mapillary`, `mapillary-signs`, `openstreetcam`
+* __`presets`__ - A path to an external presets file.
+ _Example:_ `presets=https://path/to/presets.json`
* __`rtl=true`__ - Force iD into right-to-left mode (useful for testing).
+* __`source`__ - Prefills the changeset source. Pass a url encoded string.
+ _Example:_ `source=Bing%3BMapillary`
* __`walkthrough=true`__ - Start the walkthrough automatically
##### iD on openstreetmap.org (Rails Port)