Sync rosters via the OneRoster 1.2 REST API

domain: imsglobal.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain an OAuth 2.0 Bearer token by posting client credentials to the provider's token endpoint; OneRoster 1.2 mandates OAuth 2.0 Bearer Tokens (RFC 6750) as the only permitted authentication mechanism.
  2. Discover available resources by reading the provider's base path — all OneRoster 1.2 REST paths use the prefix /ims/oneroster/rostering/v1p2 for the Rostering service; confirm the exact host and base URL from the provider's documentation.
  3. Fetch orgs, courses, classes, users, and enrollments via GET on the respective endpoints (e.g., GET /ims/oneroster/rostering/v1p2/enrollments); use limit and offset query parameters for pagination.
  4. For delta sync, apply the filter parameter dateLastModified>'{lastSyncTimestamp}' to retrieve only records changed since the previous run; the provider must support this filter per the spec's conformance requirements.
  5. Filter on status=active to exclude soft-deleted records; records with status=tobedeleted should trigger deletion in your local system.
  6. Write received records to your local data store, matching on sourcedId as the stable identifier; upsert on sourcedId to handle both creates and updates in a single pass.

Known gotchas

Related routes

Sync student and section rosters from Infinite Campus using its OneRoster 1.2 REST API
infinitecampus.com · 6 steps · unrated
Sync student rosters from a district SIS using OneRoster 1.1 REST API
imsglobal.org · 5 steps · unrated
Implement incremental OneRoster 1.2 delta sync to fetch only changed roster objects since last run
imsglobal.org · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans