Implement LTI Advantage Deep Linking

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

Steps

  1. Ensure your tool registration includes a deep linking content selection URL and declares support for the LtiDeepLinkingRequest message type; the platform uses this URL when an instructor initiates content selection.
  2. Receive and validate the LtiDeepLinkingRequest JWT using the same OIDC launch flow as a standard LTI 1.3 resource link launch; confirm the message_type claim is LtiDeepLinkingRequest and extract the deep_linking_settings claim for deep_link_return_url and accepted_types.
  3. Present a content selection interface to the user filtered by the accepted_types array (e.g., ltiResourceLink, link, html, image, file); only offer item types the platform declared it accepts.
  4. Construct a Deep Linking Response JWT signed with your tool's private key; include the claim https://purl.imsglobal.org/spec/lti-dl/claim/content_items as a JSON array of selected content item objects, and set the deployment_id and the data value from deep_linking_settings.
  5. Auto-submit an HTML form via POST to the deep_link_return_url with a single field JWT containing the signed response JWT; this returns the selected items to the LMS in the user's browser session.
  6. In the LMS, verify that the returned content items appear as expected links or assignments; test with at least one ltiResourceLink item type that the platform can subsequently launch.

Known gotchas

Related routes

Implement LTI 1.3 Deep Linking 2.0 so a tool returns a content item selection to the platform
imsglobal.org · 6 steps · unrated
Return multiple content item types via LTI Deep Linking 2.0 including an ltiResourceLink and a fileItem
imsglobal.org · 5 steps · unrated
Implement an LTI 1.3 tool launch (OIDC flow)
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