🚀 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.
We have relocated to Instructure Developer Documentation Portal. 🎉 Please update your bookmarks. This page will automatically redirect after July 1, 2026.
API Token Scopes API
BETA: This API resource is not finalized, and there could be breaking changes before its final release.
API for retrieving API scopes
A Scope object looks like:
{
// The resource the scope is associated with
"resource": "courses",
// The localized resource name
"resource_name": "Courses",
// The controller the scope is associated to
"controller": "courses",
// The controller action the scope is associated to
"action": "index",
// The HTTP verb for the scope
"verb": "GET",
// The identifier for the scope
"scope": "url:GET|/api/v1/courses"
}
List scopes ScopesApiController#index
BETA: This API endpoint is not finalized, and there could be breaking changes before its final release.
GET /api/v1/accounts/:account_id/scopes
Scope:
url:GET|/api/v1/accounts/:account_id/scopes
GET /courses/:course_id/files/:file_id/download
Scope:
url:GET|/courses/:course_id/files/:file_id/download
GET /courses/:course_id/files/:file_id/download.:type
Scope:
url:GET|/courses/:course_id/files/:file_id/download
GET /courses/:course_id/files/:file_id/preview
Scope:
url:GET|/courses/:course_id/files/:file_id/preview
GET /quiz_statistics/:quiz_statistics_id/files/:file_id/download
Scope:
url:GET|/quiz_statistics/:quiz_statistics_id/files/:file_id/download
GET /assessment_questions/:assessment_question_id/files/:file_id/download
Scope:
url:GET|/assessment_questions/:assessment_question_id/files/:file_id/download
GET /assessment_questions/:assessment_question_id/files/:file_id/download.:type
Scope:
url:GET|/assessment_questions/:assessment_question_id/files/:file_id/download
GET /assessment_questions/:assessment_question_id/files/:file_id/preview
Scope:
url:GET|/assessment_questions/:assessment_question_id/files/:file_id/preview
GET /groups/:group_id/files/:file_id/download
Scope:
url:GET|/groups/:group_id/files/:file_id/download
GET /groups/:group_id/files/:file_id/download.:type
Scope:
url:GET|/groups/:group_id/files/:file_id/download
GET /groups/:group_id/files/:file_id/preview
Scope:
url:GET|/groups/:group_id/files/:file_id/preview
GET /accounts/:account_id/files/:file_id/download
Scope:
url:GET|/accounts/:account_id/files/:file_id/download
GET /accounts/:account_id/files/:file_id/download.:type
Scope:
url:GET|/accounts/:account_id/files/:file_id/download
GET /accounts/:account_id/files/:file_id/preview
Scope:
url:GET|/accounts/:account_id/files/:file_id/preview
GET /users/:user_id/files/:file_id/download
Scope:
url:GET|/users/:user_id/files/:file_id/download
GET /users/:user_id/files/:file_id/download.:type
Scope:
url:GET|/users/:user_id/files/:file_id/download
GET /users/:user_id/files/:file_id/preview
Scope:
url:GET|/users/:user_id/files/:file_id/preview
GET /assignments/:assignment_id/files/:id/download
Scope:
url:GET|/assignments/:assignment_id/files/:id/download
GET /files/:file_id/download
Scope:
url:GET|/files/:file_id/download
GET /quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/download
Scope:
url:GET|/quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/download
GET /quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/download.:type
Scope:
url:GET|/quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/download
GET /quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/preview
Scope:
url:GET|/quizzes/quiz_submissions/:quiz_submission_id/files/:file_id/preview
A list of scopes that can be applied to developer keys and access tokens.
Request Parameters:
| Parameter | Type | Description | |
|---|---|---|---|
| group_by | string |
The attribute to group the scopes by. By default no grouping is done.
Allowed values: |