courses

POST /v1/courses/{courseId}/aliases

Changed on Oct 10, 2026

Creates an alias for a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to create the alias or for access errors. * NOT_FOUND if the course does not exist. * ALREADY_EXISTS if the alias already exists. * FAILED_PRECONDITION if the alias requested does not make sense for the requesting user or course (for example, if a user not in a domain attempts to access a domain-scoped alias).

Request

Base URL
https://classroom.googleapis.com
URL
https://classroom.googleapis.com/v1/courses/{courseId}/aliases
Auth
OAuth 2 and OAuth 2
Implicit: https://accounts.google.com/o/oauth2/auth
Scopes: https://www.googleapis.com/auth/classroom.courses
Authorization code: https://accounts.google.com/o/oauth2/auth
Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/classroom.courses

Path parameters

courseIdstring required

Identifier of the course to alias. This identifier can be either the Classroom-assigned identifier or an alias.

Request body

aliasstring

Alias string. The format of the string indicates the desired alias scoping. * d: indicates a domain-scoped alias. Example: d:math_101 * p: indicates a project-scoped alias. Example: p:abc123 This field has a maximum length of 256 characters.

Response

Successful response