← All tags

Classroom API Reference

Interact with GitHub Classroom.

6 endpoints tagged classroom, each listing its parameters and possible responses. Search or scroll the index below to jump to a specific endpoint.

No endpoints match your search.

Get an assignment

GET /assignments/{assignment_id}

Gets a GitHub Classroom assignment. Assignment will only be returned if the current user is an administrator of the GitHub Classroom for the assignment.

Parameters

NameInRequiredDescription
assignment_idpathyesThe unique identifier of the classroom assignment.

Responses

StatusDescriptionHas JSON body
200Responseyes
404Resource not foundyes

List accepted assignments for an assignment

GET /assignments/{assignment_id}/accepted_assignments

Lists any assignment repositories that have been created by students accepting a GitHub Classroom assignment. Accepted assignments will only be returned if the current user is an administrator of the GitHub Classroom for the assignment.

Parameters

NameInRequiredDescription
assignment_idpathyesThe unique identifier of the classroom assignment.
pagequerynoThe page number of the results to fetch. For more information, see "Using pagination in the REST API."
per_pagequerynoThe number of results per page (max 100). For more information, see "Using pagination in the REST API."

Responses

StatusDescriptionHas JSON body
200Responseyes

Get assignment grades

GET /assignments/{assignment_id}/grades

Gets grades for a GitHub Classroom assignment. Grades will only be returned if the current user is an administrator of the GitHub Classroom for the assignment.

Parameters

NameInRequiredDescription
assignment_idpathyesThe unique identifier of the classroom assignment.

Responses

StatusDescriptionHas JSON body
200Responseyes
404Resource not foundyes

List classrooms

GET /classrooms

Lists GitHub Classroom classrooms for the current user. Classrooms will only be returned if the current user is an administrator of one or more GitHub Classrooms.

Parameters

NameInRequiredDescription
pagequerynoThe page number of the results to fetch. For more information, see "Using pagination in the REST API."
per_pagequerynoThe number of results per page (max 100). For more information, see "Using pagination in the REST API."

Responses

StatusDescriptionHas JSON body
200Responseyes

Get a classroom

GET /classrooms/{classroom_id}

Gets a GitHub Classroom classroom for the current user. Classroom will only be returned if the current user is an administrator of the GitHub Classroom.

Parameters

NameInRequiredDescription
classroom_idpathyesThe unique identifier of the classroom.

Responses

StatusDescriptionHas JSON body
200Responseyes
404Resource not foundyes

List assignments for a classroom

GET /classrooms/{classroom_id}/assignments

Lists GitHub Classroom assignments for a classroom. Assignments will only be returned if the current user is an administrator of the GitHub Classroom.

Parameters

NameInRequiredDescription
classroom_idpathyesThe unique identifier of the classroom.
pagequerynoThe page number of the results to fetch. For more information, see "Using pagination in the REST API."
per_pagequerynoThe number of results per page (max 100). For more information, see "Using pagination in the REST API."

Responses

StatusDescriptionHas JSON body
200Responseyes