Skip to main content
OpenStreetMap
OpenStreetMap
85 actions · 2 auth methods
Preview

​
Authentication

OAuth 2.0

OpenStreetMap requires OAuth 2.0 for all editing operations (create/update/delete elements, changesets, notes, GPS trace…Guides: Connector Profile, Link Account

No Authentication (public APIs only)

Connect without credentials to use OpenStreetMap’s public APIs only: Nominatim geocoding (search/reverse/lookup/details/…Guides: Connector Profile, Link Account
Actions
|
|
85 actions
Action
Description
Required scopes
Get Api Versions
List API versions supported by the server
Get Capabilities
Get server capabilities and limits (max bbox, changeset element cap, timeouts)
Get Permissions
List OAuth permissions granted to the current token
Get Map Data
Fetch all nodes/ways/relations within a bounding box
Create Changeset
Open a new changeset (returns its ID)
Get Changeset
Read a changeset’s metadata (optionally with discussion)
Update Changeset
Update the tags of an open changeset
Close Changeset
Close an open changeset
Download Changeset
Download the changes in a changeset as an OsmChange document
Upload Changeset
Upload an OsmChange diff to a changeset atomically (all-or-nothing)
List Changesets
Query changesets by bbox, user, time, and open/closed state
Comment Changeset
Add a comment to a closed changeset’s discussion
Subscribe Changeset
Subscribe to a changeset’s discussion notifications
Unsubscribe Changeset
Unsubscribe from a changeset’s discussion
Unhide Changeset Comment
Unhide a previously hidden changeset comment (moderator)
Hide Changeset Comment
Hide a changeset comment (moderator)
Create Node
Create a new node in an open changeset
Get Node
Read the current version of a node
Update Node
Update a node (optimistic-lock on version)
Delete Node
Delete a node
Get Node History
Fetch all versions of a node
Get Node Version
Fetch a specific version of a node
Get Nodes
Multi-fetch nodes by ID list
Get Node Relations
List relations that reference this node
Get Node Ways
List ways that use this node
Redact Node Version
Redact/un-redact a node version (moderator)
Create Way
Create a new way (references node IDs, max 2000)
Get Way
Read the current version of a way
Update Way
Update a way (optimistic-lock on version)
Delete Way
Delete a way
Get Way History
Fetch all versions of a way
Get Way Version
Fetch a specific version of a way
Get Ways
Multi-fetch ways by ID list
Get Way Relations
List relations that reference this way
Get Way Full
Fetch a way plus all its member nodes
Redact Way Version
Redact/un-redact a way version (moderator)
Create Relation
Create a new relation (references member elements)
Get Relation
Read the current version of a relation
Update Relation
Update a relation (optimistic-lock on version)
Delete Relation
Delete a relation
Get Relation History
Fetch all versions of a relation
Get Relation Version
Fetch a specific version of a relation
Get Relations
Multi-fetch relations by ID list
Get Relation Relations
List relations that reference this relation
Get Relation Full
Fetch a relation plus all referenced members
Redact Relation Version
Redact/un-redact a relation version (moderator)
Get Trackpoints
Fetch raw public GPS trackpoints within a bounding box (paged, 5000/page)
Create Gpx Trace
Upload a new GPX trace file
Get Gpx Trace Details
Read a GPS trace’s metadata
Get Gpx Trace Data
Download the raw GPS trace data file
Update Gpx Trace
Update a GPS trace’s metadata (owner only)
Delete Gpx Trace
Delete a GPS trace (owner only)
List Own Gpx Traces
List the authenticated user’s own GPS traces
Get User
Read a user’s public profile by numeric ID
Get Users
Multi-fetch user details by ID list
Get Current User
Read the authenticated user’s own profile details
Get User Preferences
Read all of the authenticated user’s preferences
Replace User Preferences
Replace the authenticated user’s entire preference set
Get User Preference
Read a single preference value by key
Delete User Preference
Delete a single preference by key
List Notes
Fetch map notes within a bounding box
Get Note
Read a single note and its comment thread
Create Note
Create a new map note (anonymous allowed; write_notes if authenticated)
Comment Note
Add a comment to an open note (auth required)
Close Note
Close (resolve) a note
Reopen Note
Reopen a closed note
Subscribe Note
Subscribe to a note’s updates
Unsubscribe Note
Unsubscribe from a note’s updates
Hide Note
Hide (delete) a note (moderator)
Search Notes
Search notes by text, author, and date
Get Notes Feed
RSS feed of note activity (optionally by bbox)
List Inbox Messages
List the authenticated user’s received private messages
List Outbox Messages
List the authenticated user’s sent private messages
Send Message
Send a private message to another user
Get Message
Read a single private message (marks it read)
Update Message Status
Update a message’s read/unread flag
Delete Message
Delete a private message
Geocode Search
Forward geocode: find places by free-form or structured address/name
Reverse Geocode
Reverse geocode: build an address from a lat/lon coordinate
Lookup Osm Objects
Look up address details for known OSM objects by ID
Get Place Details
Show full internal details of a single place
Nominatim Status
Report whether the Nominatim service/database is up
Run Overpass Query
Execute an Overpass QL query and return matching OSM data
Overpass Status
Report current rate-limit slots and quota for the caller’s IP
Kill Overpass Queries
Terminate the caller’s currently running Overpass queries

​
Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.

Connector Profile

OpenStreetMap - OAuth 2.0

Connector Profile

OpenStreetMap - No Authentication (public APIs only)
3

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

OpenStreetMap - OAuth 2.0

Link Account

OpenStreetMap - No Authentication (public APIs only)
4

Use Actions

Invoke actions using one of the methods below:
  • MCP – Model Context Protocol for AI assistants
  • A2A – Agent-to-Agent protocol
  • Agent SDK – TypeScript and Python SDKs for AI agents
  • Actions RPC – Direct API calls
  • Playground – Test actions in the dashboard