> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.scholarlysoftware.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a course evaluation period ## OpenAPI ````yaml /openapi.json post /api/v1/course_evaluation_periods openapi: 3.1.0 info: title: Scholarly API V1 version: v1 description: API for accessing Scholarly data license: name: Proprietary identifier: Proprietary servers: - url: https://api.scholarlysoftware.com description: Production server security: [] paths: /api/v1/course_evaluation_periods: post: tags: - Course Evaluation Periods summary: Create a course evaluation period operationId: createCourseEvaluationPeriod parameters: - name: Authorization in: header required: true description: Bearer token schema: type: string requestBody: content: application/vnd.api+json: schema: $ref: '#/components/schemas/CreateCourseEvaluationPeriod' responses: '201': description: course evaluation period created content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/CourseEvaluationPeriod' required: - data '401': description: unauthorized content: application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '403': description: forbidden content: application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '422': description: validation error content: application/vnd.api+json: schema: $ref: '#/components/schemas/ValidationError' security: - bearer_auth: [] components: schemas: CreateCourseEvaluationPeriod: type: object properties: data: type: object properties: type: type: string const: course_evaluation_period example: course_evaluation_period attributes: type: object properties: name: type: string example: Fall 2026 Course Evaluations evaluation_type: type: string enum: - end_of_term - midterm - custom kind: type: string enum: - section - instructor results_release_at: type: - string - 'null' format: datetime description: >- When each evaluation's results release. An evaluation may override it. A blank date never releases results. minimum_response_threshold: type: - integer - 'null' description: >- Each evaluation's results stay hidden until it has this many completed responses. An evaluation may override it. A blank threshold never releases results. flag_answers_at_or_below: type: - integer - 'null' description: >- Results flag a scale question when any answer is at or below this value. An evaluation may override it. A blank value turns the rule off. flag_standard_deviation_above: type: - number - 'null' description: >- Results flag a scale question when its standard deviation exceeds this value. An evaluation may override it. A blank value turns the rule off. results_visible_to_roles: type: array items: type: string enum: - instructor - department_admin results_guidelines: type: - string - 'null' description: >- Rich text (minimal HTML) shown above the results of every evaluation in the period, on the page and in the PDFs course_uuids: type: array description: >- UUIDs of the covered course_evaluation_courses. Writing replaces the set: an evaluation is added for every section of an added course in the period's term, and removing a course destroys its evaluations and their responses. items: type: string format: uuid required: - name - evaluation_type relationships: type: object properties: term: type: object properties: data: type: object required: - type - id properties: type: type: string const: course_evaluation_term example: course_evaluation_term id: type: string format: uuid required: - data required: - type - attributes - relationships required: - data CourseEvaluationPeriod: type: object properties: id: type: string format: uuid type: type: string const: course_evaluation_period example: course_evaluation_period attributes: type: object properties: created_at: type: string format: datetime updated_at: type: string format: datetime name: type: string example: Fall 2026 Course Evaluations evaluation_type: type: string enum: - end_of_term - midterm - custom kind: type: string enum: - section - instructor draft: type: boolean status: type: string enum: - draft - scheduled - open - closed - released description: Computed from draft, the schedule, and results_release_at results_release_at: type: - string - 'null' format: datetime description: >- When each evaluation's results release. An evaluation may override it. A blank date never releases results. minimum_response_threshold: type: - integer - 'null' description: >- Each evaluation's results stay hidden until it has this many completed responses. An evaluation may override it. A blank threshold never releases results. flag_answers_at_or_below: type: - integer - 'null' description: >- Results flag a scale question when any answer is at or below this value. An evaluation may override it. A blank value turns the rule off. flag_standard_deviation_above: type: - number - 'null' description: >- Results flag a scale question when its standard deviation exceeds this value. An evaluation may override it. A blank value turns the rule off. results_visible_to_roles: type: array items: type: string enum: - instructor - department_admin results_guidelines: type: - string - 'null' description: >- Rich text (minimal HTML) shown above the results of every evaluation in the period, on the page and in the PDFs course_uuids: type: array description: >- UUIDs of the covered course_evaluation_courses. Writing replaces the set: an evaluation is added for every section of an added course in the period's term, and removing a course destroys its evaluations and their responses. items: type: string format: uuid relationships: type: object properties: term: type: object properties: links: type: object properties: related: type: string format: uri required: - related meta: type: object data: type: object required: - type - id properties: type: type: string const: course_evaluation_term example: course_evaluation_term id: type: string format: uuid anyOf: - required: - links - required: - meta - required: - data schedule: type: object properties: links: type: object properties: related: type: - string - 'null' format: uri required: - related meta: type: object data: oneOf: - type: object required: - type - id properties: type: type: string const: course_evaluation_period_schedule example: course_evaluation_period_schedule id: type: string format: uuid - type: 'null' anyOf: - required: - links - required: - meta - required: - data evaluations: type: object properties: links: type: object properties: related: type: - string - 'null' format: uri required: - related meta: type: object data: type: array items: type: object required: - type - id properties: type: type: string const: course_evaluation example: course_evaluation id: type: string format: uuid anyOf: - required: - links - required: - meta - required: - data question_sets: type: object properties: links: type: object properties: related: type: - string - 'null' format: uri required: - related meta: type: object data: type: array items: type: object required: - type - id properties: type: type: string const: course_evaluation_question_set example: course_evaluation_question_set id: type: string format: uuid description: Ordered as presented to students anyOf: - required: - links - required: - meta - required: - data courses: type: object properties: links: type: object properties: related: type: - string - 'null' format: uri required: - related meta: type: object data: type: array items: type: object required: - type - id properties: type: type: string const: course_evaluation_course example: course_evaluation_course id: type: string format: uuid description: The courses covered by the period's evaluations anyOf: - required: - links - required: - meta - required: - data required: - id - type - attributes Error: type: object properties: errors: type: array items: type: object properties: status: type: string title: type: string detail: type: string required: - status - title required: - errors ValidationError: type: object properties: errors: type: array items: type: object properties: status: type: string example: '422' title: type: string example: Validation Error detail: type: string example: Label can't be blank required: - status - title - detail required: - errors securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: API Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.