🚀 Heads up: Our API Docs Have Moved!
We have relocated to Instructure Developer Documentation Portal. 🎉 Please update your bookmarks. This page will automatically redirect after July 1, 2026.

Notice Handlers API

API for the LTI Platform Notification Service.

Requires LTI Advantage (JWT OAuth2) tokens with the https://purl.imsglobal.org/spec/lti/scope/noticehandlers scope.

See the Canvas Platform Notification Service intro guide for an overview of these endpoints and information on specific notice types.

A NoticeCatalog object looks like:

// Set of notice handlers (one per notice type) for an LTI tool deployment.
{
  // The LTI tool's client ID (global developer key ID)
  "client_id": "10000000000001",
  // String that identifies the Platform-Tool integration governing the notices
  "deployment_id": "123:8865aa05b4b79b64a91a86042e43af5ea8ae79eb",
  // List of notice handlers for the tool
  "notice_handlers": [{"handler":"","notice_type":"LtiHelloWorldNotice"}]
}

A NoticeHandler object looks like:

// A notice handler for a particular tool deployment and notice type.
{
  // URL to receive the notice
  "handler": "https://example.com/notice_handler",
  // The type of notice
  "notice_type": "LtiHelloWorldNotice",
  // The maximum number of notices to include in a single batch, or 'null' if not
  // set.
  "max_batch_size": 100
}

Show notice handlers Lti::Ims::NoticeHandlersController#index

GET /api/lti/notice-handlers/:context_external_tool_id

Scope: url:GET|/api/lti/notice-handlers/:context_external_tool_id

List all notice handlers for the tool

Example Response:

{
  "client_id": 10000000000267,
  "deployment_id": "123:8865aa05b4b79b64a91a86042e43af5ea8ae79eb",
  "notice_handlers": [
    {
      "handler": "",
      "notice_type": "LtiHelloWorldNotice"
    }
  ]
}
Returns a NoticeCatalog object

Set notice handler Lti::Ims::NoticeHandlersController#update

PUT /api/lti/notice-handlers/:context_external_tool_id

Scope: url:PUT|/api/lti/notice-handlers/:context_external_tool_id

Subscribe (set) or unsubscribe (remove) a notice handler for the tool

Request Parameters:

Parameter Type Description
notice_type Required string

The type of notice
handler Required string

URL to receive the notice, or an empty string to unsubscribe
max_batch_size integer

The maximum number of notices to include in a single batch

Example Response:

{
    "handler": "",
    "notice_type": "LtiHelloWorldNotice"
}
Returns a NoticeHandler object