Get API permissions

Returns the permissions granted to the current API connection.

• If the API client is not authorized, an empty list of permissions will be returned.
• If the API client uses OAuth 2.0, the list will be based on the granted scopes.

• For previously available Basic Auth, the list of permissions contained all permissions(1).

1. Basic Auth was removed in June 2024.

Request

/api/0.6/permissions

Response

<?xml version="1.0" encoding="UTF-8"?>
<osm version="0.6" generator="OpenStreetMap server" copyright="OpenStreetMap and contributors" attribution="http://www.openstreetmap.org/copyright" license="http://opendatacommons.org/licenses/odbl/1-0/">
    <permissions>
        <permission name="allow_read_prefs"/>
        <permission name="allow_write_prefs"/>
        <permission name="allow_write_diary"/>
        <permission name="allow_write_api"/>
        <permission name="allow_write_changeset_comments"/>
        <permission name="allow_read_gpx"/>
        <permission name="allow_write_gpx"/>
        <permission name="allow_write_notes"/>
        <permission name="allow_write_redactions"/>
        <permission name="allow_write_blocks"/>
        <permission name="allow_consume_messages"/>
        <permission name="allow_send_messages"/>
    </permissions>
</osm>

Additional information

Current permissions corresponding to the older ones

OAuth 2.0	OAuth 1.0
allow_read_prefs	read user preferences
allow_write_diary	modify user preferences
allow_write_diary	create diary entries, comments and make friends
allow_write_api	modify the map
allow_write_changeset_comments	comment on changesets
allow_write_redactions	redact element versions
allow_read_gpx	read private GPS traces
allow_write_gpx	upload GPS traces
allow_write_notes	modify notes
allow_write_redactions	redact map data
allow_write_blocks	create and revoke user block
allow_consume_messages	read, update status and delete user messages
allow_send_messages	send private messages to other users