CampusAPI Chronicle Services API documentation version 1.0.5
Based on OSID version 3.0.0
https://base.url/chronicle
Overview
The Chronicle package provides services for examining the academic record. The entries in the academic record provide summary information for students in programs and courses as well as any credentials, awards, or standardized assessment scores the student may have received.
Chronicle provides services for creating and updating entries. The entries may be provided as read-only in response to data stored in other OSIDs or updates may be provided to override generated entries or manually insert new entries.
Quick access to these entries on a per student basis may be done in the AcademicRecord service.
This package includes the following entities:
ProgramEntries
A learner record entry for a Program. The fields in the ProgramEntry may be for the entire enrollment through the academic career or specific to a Term.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this program entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this program entry, provided by system. | string(uri) |
displayName | The name of this program entry for display. | string |
description | The description of this program entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this program entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this program entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this program entry. | string(date‑time) |
endDate | The ending date of this program entry. | string(date‑time) |
endReasonId | The reason this program entry ended. References a process.State object. | string(osid‑id) |
studentId (read‑only) | The student associated with this program entry. References a resource.Resource object. | string(osid‑id) |
programId (read‑only) | The program associated with this program entry. References a program.Program object. | string(osid‑id) |
admissionDate | The date in which the student was admitted. | string(date‑time) |
complete | Tests if the program has been completed. | boolean |
termId | The Term. References a course.Term object | string(osid‑id) |
creditScaleId | The GradeSystem. References a grading.GradeSystem object | string(osid‑id) |
creditsEarned | The number of credits earned in this program or earned within the included term. | number |
gpaScaleId | The GradeSystem. References a grading.GradeSystem object | string(osid‑id) |
gpa | The cumulative GPA in this porgram or within the included term. | number |
CourseEntries
A learner record entry for a Course. The fields in the CourseEntry are specific to a Term.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this course entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this course entry, provided by system. | string(uri) |
displayName | The name of this course entry for display. | string |
description | The description of this course entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this course entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this course entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this course entry. | string(date‑time) |
endDate | The ending date of this course entry. | string(date‑time) |
endReasonId | The reason this course entry ended. References a process.State object. | string(osid‑id) |
studentId (read‑only) | The student associated with this course entry. References a resource.Resource object. | string(osid‑id) |
courseId (read‑only) | The course associated with this course entry. References a course.Course object. | string(osid‑id) |
termId | The Term. References a course.Term object | string(osid‑id) |
complete | Tests if the course has been completed. | boolean |
creditScaleId | The GradeSystem. References a grading.GradeSystem object | string(osid‑id) |
creditsEarned | The number of credits earned in this course. | number |
gradeId | The Grade. References a grading.Grade object | string(osid‑id) |
scoreScaleId | The GradeSystem. References a grading.GradeSystem object | string(osid‑id) |
score | The cumulative score. | number |
CredentialEntries
A learner record entry for a Credential. Might also be related to a "badge" awarded to a learner based on completion of an educational Program.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this credential entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this credential entry, provided by system. | string(uri) |
displayName | The name of this credential entry for display. | string |
description | The description of this credential entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this credential entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this credential entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this credential entry. | string(date‑time) |
endDate | The ending date of this credential entry. | string(date‑time) |
endReasonId | The reason this credential entry ended. References a process.State object. | string(osid‑id) |
studentId (read‑only) | The student associated with this credential entry. References a resource.Resource object. | string(osid‑id) |
credentialId (read‑only) | The credential associated with this credential entry. References a program.Credential object. | string(osid‑id) |
dateAwarded | The award date. | string(date‑time) |
programId | The Program. References a program.Program object | string(osid‑id) |
AssessmentEntries
A learner record entry for an Assessment. This is intended to record results of standardized tests and other major assessments associated with a learner's record.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this assessment entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this assessment entry, provided by system. | string(uri) |
displayName | The name of this assessment entry for display. | string |
description | The description of this assessment entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this assessment entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this assessment entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
active (read‑only) | Whether this assessment entry is active. Active is true if operational is true and disabled is false, or enabled is true. | boolean |
enabled | Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler. | boolean |
disabled | Whether this assessment entry is administravely disabled. Administratively disabling overrides any applied enabler. | boolean |
operational (read‑only) | Whether this assessment entry is operational. This assessment entry is operational if any of the applied enablers are true. | boolean |
ruleId | An explicit rule for this assessment entry. References a rules.Rule object. | string(osid‑id) |
studentId (read‑only) | The student associated with this assessment entry. References a resource.Resource object. | string(osid‑id) |
assessmentId (read‑only) | The assessment associated with this assessment entry. References an assessment.Assessment object. | string(osid‑id) |
dateCompleted | The completion date. | string(date‑time) |
programId | The Program. References a program.Program object | string(osid‑id) |
courseId | The Course. References a course.Course object | string(osid‑id) |
gradeId | The Grade. References a grading.Grade object | string(osid‑id) |
scoreScaleId | The GradeSystem. References a grading.GradeSystem object | string(osid‑id) |
score | The cumulative score. | number |
AwardEntries
An academic record entry for a Recognition. Might also be related to a "badge" issued upon a learner in less formal or independend learning activities.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this award entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this award entry, provided by system. | string(uri) |
displayName | The name of this award entry for display. | string |
description | The description of this award entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this award entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this award entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this award entry. | string(date‑time) |
endDate | The ending date of this award entry. | string(date‑time) |
endReasonId | The reason this award entry ended. References a process.State object. | string(osid‑id) |
studentId (read‑only) | The student associated with this award entry. References a resource.Resource object. | string(osid‑id) |
awardId (read‑only) | The award associated with this award entry. References a recognition.Award object. | string(osid‑id) |
dateAwarded | The award date. | string(date‑time) |
programId | The Program. References a program.Program object | string(osid‑id) |
courseId | The Course. References a course.Course object | string(osid‑id) |
assessmentId | The Assessment. References an assessment.Assessment object | string(osid‑id) |
CourseCatalogs
Courses, ActivityUnits, CourseOfferings, Activities, and Terms can be organized into federateble catalogs. CourseCatalogs can be used to represent a set of CourseOfferings offered in a specific Term, year, or by subject area, sponsor, campus, etc.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this course catalog, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this course catalog, provided by system. | string(uri) |
displayName | The name of this course catalog for display. | string |
description | The description of this course catalog. | string |
genusTypeId (read‑only) | Id of the immutable type of this course catalog. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this course catalog. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
providerId | The provider of this course catalog. References a resource.Resource object. | string(osid‑id) |
brandingIds | The branding of this course catalog. References repository.Asset objects. | string(osid‑id)[] |
license | The licensing that applies to this course catalog. | string |
License
CampusAPI REST Documentation Copyright 2023 DXtera Institute. Based on the Open Service Interface Definitions: http://osid.org
/academic-records
Quick access to chronicle entries on a per-student basis may be done through academicRecords. These methods may be secured by an authorization implementation specifically designed for record validation.
Collection of academic-records in a system that are get-only through this endpoint.
Get academic-records in the system.
get /academic-records/{studentId}
Get academic-records in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- enrolled: (boolean)
Get all enrolled academic-records for student.
Example:
true
- completed: (boolean)
Get all completed academic-records for student.
Example:
true
- term: (string)
Get all academic-records effective within this term for student.
Example:
course.Term:9070@demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"programEntries": [
{
"id": "chronicle.ProgramEntry:1344@demo.dxtera.org",
"uri": "http://demo.dxtera.org/open/campusapi/chronicle/program-entry/chronicle.ProgramEntry%3A31415%40demo.dxtera.org",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusType": "type.Type:defaultProgramEntryType@dxtera.org",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:1344@demo.dxtera.org",
"studentId": "resource.Resource:4955@demo.dxtera.org",
"programId": "course.program.Program:4495@demo.dxtera.org",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:8475@demo.dxtera.org",
"creditScaleId": "grading.GradeSystem:7638@demo.dxtera.org",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2551@demo.dxtera.org",
"gpa": 3.14
},
{
"...": "..."
}
],
"courseEntries": [
{
"id": "chronicle.CourseEntry:2166@demo.dxtera.org",
"uri": "http://demo.dxtera.org/open/campusapi/chronicle/course-entry/chronicle.CourseEntry%3A31415%40demo.dxtera.org",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusType": "type.Type:defaultCourseEntryType@dxtera.org",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:2166@demo.dxtera.org",
"studentId": "resource.Resource:4959@demo.dxtera.org",
"courseId": "course.Course:2331@demo.dxtera.org",
"termId": "course.Term:4222@demo.dxtera.org",
"complete": true,
"creditScaleId": "grading.GradeSystem:291@demo.dxtera.org",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:2217@demo.dxtera.org",
"scoreScaleId": "grading.GradeSystem:4379@demo.dxtera.org",
"score": 3.14
},
{
"...": "..."
}
],
"credentialEntries": [
{
"id": "chronicle.CredentialEntry:8825@demo.dxtera.org",
"uri": "http://demo.dxtera.org/open/campusapi/chronicle/credential-entry/chronicle.CredentialEntry%3A31415%40demo.dxtera.org",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusType": "type.Type:defaultCredentialEntryType@dxtera.org",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8825@demo.dxtera.org",
"studentId": "resource.Resource:5053@demo.dxtera.org",
"credentialId": "course.program.Credential:5891@demo.dxtera.org",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:8462@demo.dxtera.org"
},
{
"...": "..."
}
],
"assessmentEntries": [
{
"id": "chronicle.AssessmentEntry:5210@demo.dxtera.org",
"uri": "http://demo.dxtera.org/open/campusapi/chronicle/assessment-entry/chronicle.AssessmentEntry%3A31415%40demo.dxtera.org",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusType": "type.Type:defaultAssessmentEntryType@dxtera.org",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5210@demo.dxtera.org",
"studentId": "resource.Resource:7034@demo.dxtera.org",
"assessmentId": "assessment.Assessment:9832@demo.dxtera.org",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:3933@demo.dxtera.org",
"courseId": "course.Course:4897@demo.dxtera.org",
"gradeId": "grading.Grade:296@demo.dxtera.org",
"scoreScaleId": "grading.GradeSystem:435@demo.dxtera.org",
"score": 3.14
},
{
"...": "..."
}
],
"awardEntries": [
{
"id": "chronicle.AwardEntry:8092@demo.dxtera.org",
"uri": "http://demo.dxtera.org/open/campusapi/chronicle/award-entry/chronicle.AwardEntry%3A31415%40demo.dxtera.org",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusType": "type.Type:defaultAwardEntryType@dxtera.org",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8092@demo.dxtera.org",
"studentId": "resource.Resource:562@demo.dxtera.org",
"awardId": "recognition.Award:8701@demo.dxtera.org",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:5187@demo.dxtera.org",
"courseId": "course.Course:5614@demo.dxtera.org",
"assessmentId": "assessment.Assessment:4261@demo.dxtera.org"
},
{
"...": "..."
}
]
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Collection of program-entries in a system that are get-only through this endpoint.
Get program-entries in the system.
get /academic-records/program-entries/{studentId}
Get program-entries in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- enrolled: (boolean)
Get all enrolled program-entries for student.
Example:
true
- completed: (boolean)
Get all completed program-entries for student.
Example:
true
- term: (string)
Get all program-entries effective within this term for student.
Example:
course.Term:9070@demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.ProgramEntry:8111@base.url",
"uri": "http://base.url/open/campusapi/chronicle/programEntry/chronicle.ProgramEntry%3A8111%40base.url",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusTypeId": "type.Type:defaultProgramEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleProgramEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8111@base.url",
"studentId": "resource.Resource:3797@base.url",
"programId": "course.program.Program:3863@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:7370@base.url",
"creditScaleId": "grading.GradeSystem:6192@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2763@base.url",
"gpa": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Collection of course-entries in a system that are get-only through this endpoint.
Get course-entries in the system.
get /academic-records/course-entries/{studentId}
Get course-entries in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- enrolled: (boolean)
Get all enrolled course-entries for student.
Example:
true
- completed: (boolean)
Get all completed course-entries for student.
Example:
true
- term: (string)
Get all course-entries effective within this term for student.
Example:
course.Term:9070@demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CourseEntry:5236@base.url",
"uri": "http://base.url/open/campusapi/chronicle/courseEntry/chronicle.CourseEntry%3A5236%40base.url",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusTypeId": "type.Type:defaultCourseEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5236@base.url",
"studentId": "resource.Resource:6553@base.url",
"courseId": "course.Course:2623@base.url",
"termId": "course.Term:6278@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:9507@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:4706@base.url",
"scoreScaleId": "grading.GradeSystem:3210@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Collection of credential-entries in a system that are get-only through this endpoint.
Get credential-entries in the system.
get /academic-records/credential-entries/{studentId}
Get credential-entries in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- fromDate: (string)
Get all effective credential-entries for student from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all effective credential-entries for student up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CredentialEntry:4483@base.url",
"uri": "http://base.url/open/campusapi/chronicle/credentialEntry/chronicle.CredentialEntry%3A4483%40base.url",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusTypeId": "type.Type:defaultCredentialEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCredentialEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4483@base.url",
"studentId": "resource.Resource:7087@base.url",
"credentialId": "course.program.Credential:1492@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:1925@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Collection of assessment-entries in a system that are get-only through this endpoint.
Get assessment-entries in the system.
get /academic-records/assessment-entries/{studentId}
Get assessment-entries in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- fromDate: (string)
Get all effective assessment-entries for student from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all effective assessment-entries for student up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AssessmentEntry:4022@base.url",
"uri": "http://base.url/open/campusapi/chronicle/assessmentEntry/chronicle.AssessmentEntry%3A4022%40base.url",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusTypeId": "type.Type:defaultAssessmentEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4022@base.url",
"studentId": "resource.Resource:5729@base.url",
"assessmentId": "assessment.Assessment:7021@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:987@base.url",
"courseId": "course.Course:9633@base.url",
"gradeId": "grading.Grade:9675@base.url",
"scoreScaleId": "grading.GradeSystem:2872@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Collection of award-entries in a system that are get-only through this endpoint.
Get award-entries in the system.
get /academic-records/award-entries/{studentId}
Get award-entries in the system.
URI Parameters
- studentId: required(string)
Query Parameters
- fromDate: (string)
Get all effective award-entries for student from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all effective award-entries for student up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AwardEntry:736@base.url",
"uri": "http://base.url/open/campusapi/chronicle/awardEntry/chronicle.AwardEntry%3A736%40base.url",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusTypeId": "type.Type:defaultAwardEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAwardEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:736@base.url",
"studentId": "resource.Resource:7687@base.url",
"awardId": "recognition.Award:8211@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:866@base.url",
"courseId": "course.Course:1495@base.url",
"assessmentId": "assessment.Assessment:8403@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
/program-entries
Collection of ProgramEntries in a system, federation of systems, or in a default CourseCatalog.
Get all ProgramEntries in the system or default CourseCatalog.
Create a new ProgramEntry in the default CourseCatalog.
get /program-entries
Get all ProgramEntries in the system or default CourseCatalog.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "gpaScale", "student", "program", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleProgramEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleProgramEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleProgramEntryType%40campusapi.org
- fromDate: (string)
Get all program-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all program-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- studentId: (string)
the id string to match a student.
Example:
resource.Resource%3A672%40base.url
- programId: (string)
the id string to match a program.
Example:
program.Program%3A588%40base.url
- courseCatalogId: (string)
The id string to match a courseCatalog
Example:
course.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.ProgramEntry:8111@base.url",
"uri": "http://base.url/open/campusapi/chronicle/programEntry/chronicle.ProgramEntry%3A8111%40base.url",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusTypeId": "type.Type:defaultProgramEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleProgramEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8111@base.url",
"studentId": "resource.Resource:3797@base.url",
"programId": "course.program.Program:3863@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:7370@base.url",
"creditScaleId": "grading.GradeSystem:6192@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2763@base.url",
"gpa": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /program-entries
Create a new ProgramEntry in the default CourseCatalog.
Query Parameters
- studentId: required(string)
the student of this program-entry.
Example:
resource.Resource%3A672%40base.url
- programId: required(string)
the program of this program-entry.
Example:
program.Program%3A588%40base.url
- genusType: (string)
specify a particular programEntry type to create
Example:
type.Type%3AexampleProgramEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more programEntry record types
Example:
[ "type.Type%3AexampleProgramEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this programEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "ProgramEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this program entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this program entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this program entry for display.",
"type": "string"
},
"description": {
"description": "The description of this program entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this program entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this program entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this program entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this program entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this program entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this program entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"programId": {
"description": "The program associated with this program entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"admissionDate": {
"description": "The date in which the student was admitted.",
"type": "string",
"format": "date-time"
},
"complete": {
"description": "Tests if the program has been completed.",
"type": "boolean"
},
"termId": {
"description": "The Term.",
"type": "string",
"format": "osid-id"
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"creditsEarned": {
"description": "The number of credits earned in this program or earned within the included term.",
"type": "number"
},
"gpaScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"gpa": {
"description": "The cumulative GPA in this porgram or within the included term.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:7401@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:4226@base.url",
"creditScaleId": "grading.GradeSystem:5409@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:8132@base.url",
"gpa": 3.14
}
Query the collection of ProgramEntries in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a ProgramEntryQuery object.
post /program-entries/program-entry-query
Submit a query using a ProgramEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "gpaScale", "student", "program", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "ProgramEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match ProgramEntries with any end reason, false to match ProgramEntries with no end reason",
"type": "boolean"
},
"matchStudentIds": {
"description": "List of student Ids for this query to match program entry that have a related student.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"studentQueries": {
"description": "StudentQueries to match the student. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchProgramIds": {
"description": "List of program Ids for this query to match program entry that have a related program.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"programQueries": {
"description": "ProgramQueries to match the program. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAdmissionDate": {
"description": "Matches admissionDates between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyAdmissionDate": {
"description": "Match admissionDates with any value. true to match ProgramEntries with any admission date, false to match ProgramOfferings with no admission date",
"type": "boolean"
},
"matchComplete": {
"description": "Match boolean value for complete.",
"type": "object",
"properties": {
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
},
"matchTermIds": {
"description": "List of Term Ids for this query to match term.",
"type": "array",
"items": {
"type": "object",
"properties": {
"termId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"termQueries": {
"description": "course.TermQueries to match the Term. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyTerm": {
"description": "Match term with any value. true to match ProgramEntries with any term, false to match ProgramEntries with no term",
"type": "boolean"
},
"matchCreditScaleIds": {
"description": "List of GradeSystem Ids for this query to match creditScale.",
"type": "array",
"items": {
"type": "object",
"properties": {
"creditScaleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"creditScaleQueries": {
"description": "grading.GradeSystemQueries to match the Credit Scale. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyCreditScale": {
"description": "Match credit scale with any value. true to match ProgramEntries with any credit scale, false to match ProgramEntries with no credit scale",
"type": "boolean"
},
"matchCreditsEarned": {
"description": "Match CreditsEarned within the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "starting value",
"type": "number"
},
"to": {
"description": "ending value",
"type": "number"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyCreditsEarned": {
"description": "Match creditsEarneds with any value. true to match ProgramEntries with any credits earned, false to match ProgramOfferings with no credits earned",
"type": "boolean"
},
"matchGpaScaleIds": {
"description": "List of GradeSystem Ids for this query to match gpaScale.",
"type": "array",
"items": {
"type": "object",
"properties": {
"gpaScaleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"gpaScaleQueries": {
"description": "grading.GradeSystemQueries to match the GPA Scale. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyGpaScale": {
"description": "Match gpa scale with any value. true to match ProgramEntries with any gpa scale, false to match ProgramEntries with no gpa scale",
"type": "boolean"
},
"matchGPA": {
"description": "Match GPA within the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "starting value",
"type": "number"
},
"to": {
"description": "ending value",
"type": "number"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyGPA": {
"description": "Match gpas with any value. true to match ProgramEntries with any gpa, false to match ProgramOfferings with no gpa",
"type": "boolean"
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.ProgramEntry:8111@base.url",
"uri": "http://base.url/open/campusapi/chronicle/programEntry/chronicle.ProgramEntry%3A8111%40base.url",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusTypeId": "type.Type:defaultProgramEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleProgramEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8111@base.url",
"studentId": "resource.Resource:3797@base.url",
"programId": "course.program.Program:3863@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:7370@base.url",
"creditScaleId": "grading.GradeSystem:6192@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2763@base.url",
"gpa": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a ProgramEntry form metadata.
Get form metadata for creating a new ProgramEntry.
get /program-entries/metadata
Get form metadata for creating a new ProgramEntry.
Query Parameters
- studentId: required(string)
the student of this metadatum.
Example:
resource.Resource%3A672%40base.url
- programId: required(string)
the program of this metadatum.
Example:
program.Program%3A588%40base.url
- genusType: (string)
specify a particular programEntry type to create
Example:
type.Type%3AexampleProgramEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more programEntry record types
Example:
[ "type.Type%3AexampleProgramEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this programEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "ProgramEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this program entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this program entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this program entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this program entry",
"linked": false
},
"description": {
"description": "The description of this program entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this program entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this program entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this program entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this program entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this program entry",
"linked": false
},
"endDate": {
"description": "The ending date of this program entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this program entry",
"linked": false
},
"endReasonId": {
"description": "The reason this program entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this program entry ended",
"linked": false
},
"admissionDate": {
"description": "The date in which the student was admitted.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:admissionDate@dxtera.org",
"existingValue": "",
"elementLabel": "Admission Date",
"instructions": "Enter the admission date of this program entry.",
"linked": false
},
"complete": {
"description": "Tests if the program has been completed.",
"type": "boolean",
"elementId": "course.chronicle.ProgramEntry:complete@dxtera.org",
"existingValue": false,
"elementLabel": "Complete",
"instructions": "Enter true or false.",
"linked": false
},
"termId": {
"description": "The Term.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:term@dxtera.org",
"existingValue": null,
"elementLabel": "Term",
"instructions": "Enter the Id of the term for this program entry.",
"linked": false
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:creditScale@dxtera.org",
"existingValue": null,
"elementLabel": "Credit Scale",
"instructions": "Enter the Id of the credit scale for this program entry.",
"linked": false
},
"creditsEarned": {
"description": "The number of credits earned in this program or earned within the included term.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.ProgramEntry:creditsEarned@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Credits Earned",
"instructions": "Enter the credits earned of this program entry.",
"linked": false
},
"gpaScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:gpaScale@dxtera.org",
"existingValue": null,
"elementLabel": "GPA Scale",
"instructions": "Enter the Id of the gpa scale for this program entry.",
"linked": false
},
"gpa": {
"description": "The cumulative GPA in this porgram or within the included term.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.ProgramEntry:gpa@dxtera.org",
"existingValue": 3.14,
"elementLabel": "GPA",
"instructions": "Enter the gpa of this program entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a ProgramEntry
Get a particular ProgramEntry given its id.
Update a particular ProgramEntry given its id.
Delete a particular ProgramEntry given its id.
get /program-entries/{programEntryId}
Get a particular ProgramEntry given its id.
URI Parameters
- programEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "gpaScale", "student", "program", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "chronicle.ProgramEntry:8111@base.url",
"uri": "http://base.url/open/campusapi/chronicle/programEntry/chronicle.ProgramEntry%3A8111%40base.url",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusTypeId": "type.Type:defaultProgramEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleProgramEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8111@base.url",
"studentId": "resource.Resource:3797@base.url",
"programId": "course.program.Program:3863@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:7370@base.url",
"creditScaleId": "grading.GradeSystem:6192@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2763@base.url",
"gpa": 3.14
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "ProgramEntry not found" }
put /program-entries/{programEntryId}
Update a particular ProgramEntry given its id.
URI Parameters
- programEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "ProgramEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this program entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this program entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this program entry for display.",
"type": "string"
},
"description": {
"description": "The description of this program entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this program entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this program entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this program entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this program entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this program entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this program entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"programId": {
"description": "The program associated with this program entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"admissionDate": {
"description": "The date in which the student was admitted.",
"type": "string",
"format": "date-time"
},
"complete": {
"description": "Tests if the program has been completed.",
"type": "boolean"
},
"termId": {
"description": "The Term.",
"type": "string",
"format": "osid-id"
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"creditsEarned": {
"description": "The number of credits earned in this program or earned within the included term.",
"type": "number"
},
"gpaScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"gpa": {
"description": "The cumulative GPA in this porgram or within the included term.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:7401@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:4226@base.url",
"creditScaleId": "grading.GradeSystem:5409@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:8132@base.url",
"gpa": 3.14
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The ProgramEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "ProgramEntry not found" }
delete /program-entries/{programEntryId}
Delete a particular ProgramEntry given its id.
URI Parameters
- programEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The ProgramEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "ProgramEntry not found" }
Entity representing a ProgramEntry form metadata for update
Get form metadata for updating an existing ProgramEntry.
get /program-entries/{programEntryId}/metadata
Get form metadata for updating an existing ProgramEntry.
URI Parameters
- programEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "ProgramEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this program entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this program entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this program entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this program entry",
"linked": false
},
"description": {
"description": "The description of this program entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this program entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this program entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this program entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this program entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this program entry",
"linked": false
},
"endDate": {
"description": "The ending date of this program entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this program entry",
"linked": false
},
"endReasonId": {
"description": "The reason this program entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "ProgramEntry.ProgramEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this program entry ended",
"linked": false
},
"admissionDate": {
"description": "The date in which the student was admitted.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:admissionDate@dxtera.org",
"existingValue": "",
"elementLabel": "Admission Date",
"instructions": "Enter the admission date of this program entry.",
"linked": false
},
"complete": {
"description": "Tests if the program has been completed.",
"type": "boolean",
"elementId": "course.chronicle.ProgramEntry:complete@dxtera.org",
"existingValue": false,
"elementLabel": "Complete",
"instructions": "Enter true or false.",
"linked": false
},
"termId": {
"description": "The Term.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:term@dxtera.org",
"existingValue": null,
"elementLabel": "Term",
"instructions": "Enter the Id of the term for this program entry.",
"linked": false
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:creditScale@dxtera.org",
"existingValue": null,
"elementLabel": "Credit Scale",
"instructions": "Enter the Id of the credit scale for this program entry.",
"linked": false
},
"creditsEarned": {
"description": "The number of credits earned in this program or earned within the included term.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.ProgramEntry:creditsEarned@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Credits Earned",
"instructions": "Enter the credits earned of this program entry.",
"linked": false
},
"gpaScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.ProgramEntry:gpaScale@dxtera.org",
"existingValue": null,
"elementLabel": "GPA Scale",
"instructions": "Enter the Id of the gpa scale for this program entry.",
"linked": false
},
"gpa": {
"description": "The cumulative GPA in this porgram or within the included term.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.ProgramEntry:gpa@dxtera.org",
"existingValue": 3.14,
"elementLabel": "GPA",
"instructions": "Enter the gpa of this program entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "programEntry not found" }
/course-entries
Collection of CourseEntries in a system, federation of systems, or in a default CourseCatalog.
Get all CourseEntries in the system or default CourseCatalog.
Create a new CourseEntry in the default CourseCatalog.
get /course-entries
Get all CourseEntries in the system or default CourseCatalog.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "grade", "scoreScale", "student", "course", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleCourseEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleCourseEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleCourseEntryType%40campusapi.org
- fromDate: (string)
Get all course-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all course-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- studentId: (string)
the id string to match a student.
Example:
resource.Resource%3A616%40base.url
- courseId: (string)
the id string to match a course.
Example:
course.Course%3A396%40base.url
- courseCatalogId: (string)
The id string to match a courseCatalog
Example:
course.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CourseEntry:5236@base.url",
"uri": "http://base.url/open/campusapi/chronicle/courseEntry/chronicle.CourseEntry%3A5236%40base.url",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusTypeId": "type.Type:defaultCourseEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5236@base.url",
"studentId": "resource.Resource:6553@base.url",
"courseId": "course.Course:2623@base.url",
"termId": "course.Term:6278@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:9507@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:4706@base.url",
"scoreScaleId": "grading.GradeSystem:3210@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /course-entries
Create a new CourseEntry in the default CourseCatalog.
Query Parameters
- studentId: required(string)
the student of this course-entry.
Example:
resource.Resource%3A616%40base.url
- courseId: required(string)
the course of this course-entry.
Example:
course.Course%3A396%40base.url
- genusType: (string)
specify a particular courseEntry type to create
Example:
type.Type%3AexampleCourseEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more courseEntry record types
Example:
[ "type.Type%3AexampleCourseEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this courseEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this course entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course entry for display.",
"type": "string"
},
"description": {
"description": "The description of this course entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this course entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this course entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this course entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this course entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this course entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"courseId": {
"description": "The course associated with this course entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"termId": {
"description": "The Term.",
"type": "string",
"format": "osid-id"
},
"complete": {
"description": "Tests if the course has been completed.",
"type": "boolean"
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"creditsEarned": {
"description": "The number of credits earned in this course.",
"type": "number"
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"format": "osid-id"
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"score": {
"description": "The cumulative score.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:9253@base.url",
"termId": "course.Term:6218@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:4165@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:2130@base.url",
"scoreScaleId": "grading.GradeSystem:1303@base.url",
"score": 3.14
}
Query the collection of CourseEntries in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a CourseEntryQuery object.
post /course-entries/course-entry-query
Submit a query using a CourseEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "grade", "scoreScale", "student", "course", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match CourseEntries with any end reason, false to match CourseEntries with no end reason",
"type": "boolean"
},
"matchStudentIds": {
"description": "List of student Ids for this query to match course entry that have a related student.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"studentQueries": {
"description": "StudentQueries to match the student. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchCourseIds": {
"description": "List of course Ids for this query to match course entry that have a related course.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseQueries": {
"description": "CourseQueries to match the course. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchTermIds": {
"description": "List of Term Ids for this query to match term.",
"type": "array",
"items": {
"type": "object",
"properties": {
"termId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"termQueries": {
"description": "course.TermQueries to match the Term. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyTerm": {
"description": "Match term with any value. true to match CourseEntries with any term, false to match CourseEntries with no term",
"type": "boolean"
},
"matchComplete": {
"description": "Match boolean value for complete.",
"type": "object",
"properties": {
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
},
"matchCreditScaleIds": {
"description": "List of GradeSystem Ids for this query to match creditScale.",
"type": "array",
"items": {
"type": "object",
"properties": {
"creditScaleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"creditScaleQueries": {
"description": "grading.GradeSystemQueries to match the Credit Scale. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyCreditScale": {
"description": "Match credit scale with any value. true to match CourseEntries with any credit scale, false to match CourseEntries with no credit scale",
"type": "boolean"
},
"matchCreditsEarned": {
"description": "Match CreditsEarned within the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "starting value",
"type": "number"
},
"to": {
"description": "ending value",
"type": "number"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyCreditsEarned": {
"description": "Match creditsEarneds with any value. true to match CourseEntries with any credits earned, false to match ProgramOfferings with no credits earned",
"type": "boolean"
},
"matchGradeIds": {
"description": "List of Grade Ids for this query to match grade.",
"type": "array",
"items": {
"type": "object",
"properties": {
"gradeId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"gradeQueries": {
"description": "grading.GradeQueries to match the Grade. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyGrade": {
"description": "Match grade with any value. true to match CourseEntries with any grade, false to match CourseEntries with no grade",
"type": "boolean"
},
"matchScoreScaleIds": {
"description": "List of GradeSystem Ids for this query to match scoreScale.",
"type": "array",
"items": {
"type": "object",
"properties": {
"scoreScaleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"scoreScaleQueries": {
"description": "grading.GradeSystemQueries to match the Score Scale. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyScoreScale": {
"description": "Match score scale with any value. true to match CourseEntries with any score scale, false to match CourseEntries with no score scale",
"type": "boolean"
},
"matchScore": {
"description": "Match Score within the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "starting value",
"type": "number"
},
"to": {
"description": "ending value",
"type": "number"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyScore": {
"description": "Match scores with any value. true to match CourseEntries with any score, false to match ProgramOfferings with no score",
"type": "boolean"
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CourseEntry:5236@base.url",
"uri": "http://base.url/open/campusapi/chronicle/courseEntry/chronicle.CourseEntry%3A5236%40base.url",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusTypeId": "type.Type:defaultCourseEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5236@base.url",
"studentId": "resource.Resource:6553@base.url",
"courseId": "course.Course:2623@base.url",
"termId": "course.Term:6278@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:9507@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:4706@base.url",
"scoreScaleId": "grading.GradeSystem:3210@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CourseEntry form metadata.
Get form metadata for creating a new CourseEntry.
get /course-entries/metadata
Get form metadata for creating a new CourseEntry.
Query Parameters
- studentId: required(string)
the student of this metadatum.
Example:
resource.Resource%3A616%40base.url
- courseId: required(string)
the course of this metadatum.
Example:
course.Course%3A396%40base.url
- genusType: (string)
specify a particular courseEntry type to create
Example:
type.Type%3AexampleCourseEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more courseEntry record types
Example:
[ "type.Type%3AexampleCourseEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this courseEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CourseEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this course entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this course entry",
"linked": false
},
"description": {
"description": "The description of this course entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this course entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this course entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this course entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this course entry",
"linked": false
},
"endDate": {
"description": "The ending date of this course entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this course entry",
"linked": false
},
"endReasonId": {
"description": "The reason this course entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this course entry ended",
"linked": false
},
"termId": {
"description": "The Term.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:term@dxtera.org",
"existingValue": null,
"elementLabel": "Term",
"instructions": "Enter the Id of the term for this course entry.",
"linked": false
},
"complete": {
"description": "Tests if the course has been completed.",
"type": "boolean",
"elementId": "course.chronicle.CourseEntry:complete@dxtera.org",
"existingValue": false,
"elementLabel": "Complete",
"instructions": "Enter true or false.",
"linked": false
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:creditScale@dxtera.org",
"existingValue": null,
"elementLabel": "Credit Scale",
"instructions": "Enter the Id of the credit scale for this course entry.",
"linked": false
},
"creditsEarned": {
"description": "The number of credits earned in this course.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.CourseEntry:creditsEarned@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Credits Earned",
"instructions": "Enter the credits earned of this course entry.",
"linked": false
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:grade@dxtera.org",
"existingValue": null,
"elementLabel": "Grade",
"instructions": "Enter the Id of the grade for this course entry.",
"linked": false
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:scoreScale@dxtera.org",
"existingValue": null,
"elementLabel": "Score Scale",
"instructions": "Enter the Id of the score scale for this course entry.",
"linked": false
},
"score": {
"description": "The cumulative score.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.CourseEntry:score@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Score",
"instructions": "Enter the score of this course entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CourseEntry
Get a particular CourseEntry given its id.
Update a particular CourseEntry given its id.
Delete a particular CourseEntry given its id.
get /course-entries/{courseEntryId}
Get a particular CourseEntry given its id.
URI Parameters
- courseEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "grade", "scoreScale", "student", "course", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "chronicle.CourseEntry:5236@base.url",
"uri": "http://base.url/open/campusapi/chronicle/courseEntry/chronicle.CourseEntry%3A5236%40base.url",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusTypeId": "type.Type:defaultCourseEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5236@base.url",
"studentId": "resource.Resource:6553@base.url",
"courseId": "course.Course:2623@base.url",
"termId": "course.Term:6278@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:9507@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:4706@base.url",
"scoreScaleId": "grading.GradeSystem:3210@base.url",
"score": 3.14
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseEntry not found" }
put /course-entries/{courseEntryId}
Update a particular CourseEntry given its id.
URI Parameters
- courseEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this course entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course entry for display.",
"type": "string"
},
"description": {
"description": "The description of this course entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this course entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this course entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this course entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this course entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this course entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"courseId": {
"description": "The course associated with this course entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"termId": {
"description": "The Term.",
"type": "string",
"format": "osid-id"
},
"complete": {
"description": "Tests if the course has been completed.",
"type": "boolean"
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"creditsEarned": {
"description": "The number of credits earned in this course.",
"type": "number"
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"format": "osid-id"
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"score": {
"description": "The cumulative score.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:9253@base.url",
"termId": "course.Term:6218@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:4165@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:2130@base.url",
"scoreScaleId": "grading.GradeSystem:1303@base.url",
"score": 3.14
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CourseEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseEntry not found" }
delete /course-entries/{courseEntryId}
Delete a particular CourseEntry given its id.
URI Parameters
- courseEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CourseEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseEntry not found" }
Entity representing a CourseEntry form metadata for update
Get form metadata for updating an existing CourseEntry.
get /course-entries/{courseEntryId}/metadata
Get form metadata for updating an existing CourseEntry.
URI Parameters
- courseEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CourseEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this course entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this course entry",
"linked": false
},
"description": {
"description": "The description of this course entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this course entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this course entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this course entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this course entry",
"linked": false
},
"endDate": {
"description": "The ending date of this course entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this course entry",
"linked": false
},
"endReasonId": {
"description": "The reason this course entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseEntry.CourseEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this course entry ended",
"linked": false
},
"termId": {
"description": "The Term.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:term@dxtera.org",
"existingValue": null,
"elementLabel": "Term",
"instructions": "Enter the Id of the term for this course entry.",
"linked": false
},
"complete": {
"description": "Tests if the course has been completed.",
"type": "boolean",
"elementId": "course.chronicle.CourseEntry:complete@dxtera.org",
"existingValue": false,
"elementLabel": "Complete",
"instructions": "Enter true or false.",
"linked": false
},
"creditScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:creditScale@dxtera.org",
"existingValue": null,
"elementLabel": "Credit Scale",
"instructions": "Enter the Id of the credit scale for this course entry.",
"linked": false
},
"creditsEarned": {
"description": "The number of credits earned in this course.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.CourseEntry:creditsEarned@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Credits Earned",
"instructions": "Enter the credits earned of this course entry.",
"linked": false
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:grade@dxtera.org",
"existingValue": null,
"elementLabel": "Grade",
"instructions": "Enter the Id of the grade for this course entry.",
"linked": false
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CourseEntry:scoreScale@dxtera.org",
"existingValue": null,
"elementLabel": "Score Scale",
"instructions": "Enter the Id of the score scale for this course entry.",
"linked": false
},
"score": {
"description": "The cumulative score.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.CourseEntry:score@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Score",
"instructions": "Enter the score of this course entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "courseEntry not found" }
/credential-entries
Collection of CredentialEntries in a system, federation of systems, or in a default CourseCatalog.
Get all CredentialEntries in the system or default CourseCatalog.
Create a new CredentialEntry in the default CourseCatalog.
get /credential-entries
Get all CredentialEntries in the system or default CourseCatalog.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "student", "credential", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleCredentialEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleCredentialEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleCredentialEntryType%40campusapi.org
- fromDate: (string)
Get all credential-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all credential-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- studentId: (string)
the id string to match a student.
Example:
resource.Resource%3A840%40base.url
- credentialId: (string)
the id string to match a credential.
Example:
program.Credential%3A1050%40base.url
- courseCatalogId: (string)
The id string to match a courseCatalog
Example:
course.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CredentialEntry:4483@base.url",
"uri": "http://base.url/open/campusapi/chronicle/credentialEntry/chronicle.CredentialEntry%3A4483%40base.url",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusTypeId": "type.Type:defaultCredentialEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCredentialEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4483@base.url",
"studentId": "resource.Resource:7087@base.url",
"credentialId": "course.program.Credential:1492@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:1925@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /credential-entries
Create a new CredentialEntry in the default CourseCatalog.
Query Parameters
- studentId: required(string)
the student of this credential-entry.
Example:
resource.Resource%3A840%40base.url
- credentialId: required(string)
the credential of this credential-entry.
Example:
program.Credential%3A1050%40base.url
- genusType: (string)
specify a particular credentialEntry type to create
Example:
type.Type%3AexampleCredentialEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more credentialEntry record types
Example:
[ "type.Type%3AexampleCredentialEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this credentialEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CredentialEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this credential entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this credential entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this credential entry for display.",
"type": "string"
},
"description": {
"description": "The description of this credential entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this credential entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this credential entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this credential entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this credential entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this credential entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this credential entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"credentialId": {
"description": "The credential associated with this credential entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4576@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:3145@base.url"
}
Query the collection of CredentialEntries in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a CredentialEntryQuery object.
post /credential-entries/credential-entry-query
Submit a query using a CredentialEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "student", "credential", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CredentialEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match CredentialEntries with any end reason, false to match CredentialEntries with no end reason",
"type": "boolean"
},
"matchStudentIds": {
"description": "List of student Ids for this query to match credential entry that have a related student.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"studentQueries": {
"description": "StudentQueries to match the student. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchCredentialIds": {
"description": "List of credential Ids for this query to match credential entry that have a related credential.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"credentialQueries": {
"description": "CredentialQueries to match the credential. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchDateAwarded": {
"description": "Matches dateAwardeds between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyDateAwarded": {
"description": "Match dateAwardeds with any value. true to match CredentialEntries with any date awarded, false to match ProgramOfferings with no date awarded",
"type": "boolean"
},
"matchProgramIds": {
"description": "List of Program Ids for this query to match program.",
"type": "array",
"items": {
"type": "object",
"properties": {
"programId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"programQueries": {
"description": "program.ProgramQueries to match the Program. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyProgram": {
"description": "Match program with any value. true to match CredentialEntries with any program, false to match CredentialEntries with no program",
"type": "boolean"
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CredentialEntry:4483@base.url",
"uri": "http://base.url/open/campusapi/chronicle/credentialEntry/chronicle.CredentialEntry%3A4483%40base.url",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusTypeId": "type.Type:defaultCredentialEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCredentialEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4483@base.url",
"studentId": "resource.Resource:7087@base.url",
"credentialId": "course.program.Credential:1492@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:1925@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CredentialEntry form metadata.
Get form metadata for creating a new CredentialEntry.
get /credential-entries/metadata
Get form metadata for creating a new CredentialEntry.
Query Parameters
- studentId: required(string)
the student of this metadatum.
Example:
resource.Resource%3A840%40base.url
- credentialId: required(string)
the credential of this metadatum.
Example:
program.Credential%3A1050%40base.url
- genusType: (string)
specify a particular credentialEntry type to create
Example:
type.Type%3AexampleCredentialEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more credentialEntry record types
Example:
[ "type.Type%3AexampleCredentialEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this credentialEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CredentialEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this credential entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this credential entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this credential entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this credential entry",
"linked": false
},
"description": {
"description": "The description of this credential entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this credential entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this credential entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this credential entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this credential entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this credential entry",
"linked": false
},
"endDate": {
"description": "The ending date of this credential entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this credential entry",
"linked": false
},
"endReasonId": {
"description": "The reason this credential entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this credential entry ended",
"linked": false
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CredentialEntry:dateAwarded@dxtera.org",
"existingValue": "",
"elementLabel": "Date Awarded",
"instructions": "Enter the date awarded of this credential entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CredentialEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this credential entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CredentialEntry
Get a particular CredentialEntry given its id.
Update a particular CredentialEntry given its id.
Delete a particular CredentialEntry given its id.
get /credential-entries/{credentialEntryId}
Get a particular CredentialEntry given its id.
URI Parameters
- credentialEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "student", "credential", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "chronicle.CredentialEntry:4483@base.url",
"uri": "http://base.url/open/campusapi/chronicle/credentialEntry/chronicle.CredentialEntry%3A4483%40base.url",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusTypeId": "type.Type:defaultCredentialEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCredentialEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4483@base.url",
"studentId": "resource.Resource:7087@base.url",
"credentialId": "course.program.Credential:1492@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:1925@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CredentialEntry not found" }
put /credential-entries/{credentialEntryId}
Update a particular CredentialEntry given its id.
URI Parameters
- credentialEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CredentialEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this credential entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this credential entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this credential entry for display.",
"type": "string"
},
"description": {
"description": "The description of this credential entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this credential entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this credential entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this credential entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this credential entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this credential entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this credential entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"credentialId": {
"description": "The credential associated with this credential entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4576@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:3145@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CredentialEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CredentialEntry not found" }
delete /credential-entries/{credentialEntryId}
Delete a particular CredentialEntry given its id.
URI Parameters
- credentialEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CredentialEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CredentialEntry not found" }
Entity representing a CredentialEntry form metadata for update
Get form metadata for updating an existing CredentialEntry.
get /credential-entries/{credentialEntryId}/metadata
Get form metadata for updating an existing CredentialEntry.
URI Parameters
- credentialEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CredentialEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this credential entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this credential entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this credential entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this credential entry",
"linked": false
},
"description": {
"description": "The description of this credential entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this credential entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this credential entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this credential entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this credential entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this credential entry",
"linked": false
},
"endDate": {
"description": "The ending date of this credential entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this credential entry",
"linked": false
},
"endReasonId": {
"description": "The reason this credential entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CredentialEntry.CredentialEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this credential entry ended",
"linked": false
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CredentialEntry:dateAwarded@dxtera.org",
"existingValue": "",
"elementLabel": "Date Awarded",
"instructions": "Enter the date awarded of this credential entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.CredentialEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this credential entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "credentialEntry not found" }
/assessment-entries
Collection of AssessmentEntries in a system, federation of systems, or in a default CourseCatalog.
Get all AssessmentEntries in the system or default CourseCatalog.
Create a new AssessmentEntry in the default CourseCatalog.
get /assessment-entries
Get all AssessmentEntries in the system or default CourseCatalog.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "grade", "scoreScale", "student", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentEntryType%40campusapi.org
- fromDate: (string)
Get all assessment-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all assessment-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- studentId: (string)
the id string to match a student.
Example:
resource.Resource%3A840%40base.url
- assessmentId: (string)
the id string to match a assessment.
Example:
assessment.Assessment%3A1500%40base.url
- courseCatalogId: (string)
The id string to match a courseCatalog
Example:
course.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AssessmentEntry:4022@base.url",
"uri": "http://base.url/open/campusapi/chronicle/assessmentEntry/chronicle.AssessmentEntry%3A4022%40base.url",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusTypeId": "type.Type:defaultAssessmentEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4022@base.url",
"studentId": "resource.Resource:5729@base.url",
"assessmentId": "assessment.Assessment:7021@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:987@base.url",
"courseId": "course.Course:9633@base.url",
"gradeId": "grading.Grade:9675@base.url",
"scoreScaleId": "grading.GradeSystem:2872@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /assessment-entries
Create a new AssessmentEntry in the default CourseCatalog.
Query Parameters
- studentId: required(string)
the student of this assessment-entry.
Example:
resource.Resource%3A840%40base.url
- assessmentId: required(string)
the assessment of this assessment-entry.
Example:
assessment.Assessment%3A1500%40base.url
- genusType: (string)
specify a particular assessmentEntry type to create
Example:
type.Type%3AexampleAssessmentEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentEntry record types
Example:
[ "type.Type%3AexampleAssessmentEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this assessmentEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment entry for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"active": {
"description": "Whether this assessment entry is active. Active is true if operational is true and disabled is false, or enabled is true.",
"type": "boolean",
"readOnly": true
},
"enabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean"
},
"disabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean"
},
"operational": {
"description": "Whether this assessment entry is operational. This assessment entry is operational if any of the applied enablers are true.",
"type": "boolean",
"readOnly": true
},
"ruleId": {
"description": "An explicit Rule for this assessment entry.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this assessment entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"assessmentId": {
"description": "The assessment associated with this assessment entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateCompleted": {
"description": "The completion date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
},
"courseId": {
"description": "The Course.",
"type": "string",
"format": "osid-id"
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"format": "osid-id"
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"score": {
"description": "The cumulative score.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8817@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:3267@base.url",
"courseId": "course.Course:8789@base.url",
"gradeId": "grading.Grade:6949@base.url",
"scoreScaleId": "grading.GradeSystem:1149@base.url",
"score": 3.14
}
Query the collection of AssessmentEntries in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a AssessmentEntryQuery object.
post /assessment-entries/assessment-entry-query
Submit a query using a AssessmentEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "grade", "scoreScale", "student", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchActive": {
"description": "Matches active. true to match active, false to match inactive",
"type": "boolean"
},
"matchEnabled": {
"description": "Matches administratively enabled. true to match administratively enabled, false otherwise",
"type": "boolean"
},
"matchDisabled": {
"description": "Matches administratively disabled. true to match administratively disabled, false otherwise",
"type": "boolean"
},
"matchOperational": {
"description": "Matches operational operables. true to match operational, false to match not operational",
"type": "boolean"
},
"matchRuleIds": {
"description": "List of rule Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"ruleQueries": {
"description": "rules.RuleQuery for the cyclic event. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchStudentIds": {
"description": "List of student Ids for this query to match assessment entry that have a related student.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"studentQueries": {
"description": "StudentQueries to match the student. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAssessmentIds": {
"description": "List of assessment Ids for this query to match assessment entry that have a related assessment.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"assessmentQueries": {
"description": "AssessmentQueries to match the assessment. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchDateCompleted": {
"description": "Matches dateCompleteds between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyDateCompleted": {
"description": "Match dateCompleteds with any value. true to match AssessmentEntries with any date completed, false to match ProgramOfferings with no date completed",
"type": "boolean"
},
"matchProgramIds": {
"description": "List of Program Ids for this query to match program.",
"type": "array",
"items": {
"type": "object",
"properties": {
"programId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"programQueries": {
"description": "program.ProgramQueries to match the Program. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyProgram": {
"description": "Match program with any value. true to match AssessmentEntries with any program, false to match AssessmentEntries with no program",
"type": "boolean"
},
"matchCourseIds": {
"description": "List of Course Ids for this query to match course.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseQueries": {
"description": "course.CourseQueries to match the Course. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyCourse": {
"description": "Match course with any value. true to match AssessmentEntries with any course, false to match AssessmentEntries with no course",
"type": "boolean"
},
"matchGradeIds": {
"description": "List of Grade Ids for this query to match grade.",
"type": "array",
"items": {
"type": "object",
"properties": {
"gradeId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"gradeQueries": {
"description": "grading.GradeQueries to match the Grade. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyGrade": {
"description": "Match grade with any value. true to match AssessmentEntries with any grade, false to match AssessmentEntries with no grade",
"type": "boolean"
},
"matchScoreScaleIds": {
"description": "List of GradeSystem Ids for this query to match scoreScale.",
"type": "array",
"items": {
"type": "object",
"properties": {
"scoreScaleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"scoreScaleQueries": {
"description": "grading.GradeSystemQueries to match the Score Scale. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyScoreScale": {
"description": "Match score scale with any value. true to match AssessmentEntries with any score scale, false to match AssessmentEntries with no score scale",
"type": "boolean"
},
"matchScore": {
"description": "Match Score within the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "starting value",
"type": "number"
},
"to": {
"description": "ending value",
"type": "number"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyScore": {
"description": "Match scores with any value. true to match AssessmentEntries with any score, false to match ProgramOfferings with no score",
"type": "boolean"
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AssessmentEntry:4022@base.url",
"uri": "http://base.url/open/campusapi/chronicle/assessmentEntry/chronicle.AssessmentEntry%3A4022%40base.url",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusTypeId": "type.Type:defaultAssessmentEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4022@base.url",
"studentId": "resource.Resource:5729@base.url",
"assessmentId": "assessment.Assessment:7021@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:987@base.url",
"courseId": "course.Course:9633@base.url",
"gradeId": "grading.Grade:9675@base.url",
"scoreScaleId": "grading.GradeSystem:2872@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentEntry form metadata.
Get form metadata for creating a new AssessmentEntry.
get /assessment-entries/metadata
Get form metadata for creating a new AssessmentEntry.
Query Parameters
- studentId: required(string)
the student of this metadatum.
Example:
resource.Resource%3A840%40base.url
- assessmentId: required(string)
the assessment of this metadatum.
Example:
assessment.Assessment%3A1500%40base.url
- genusType: (string)
specify a particular assessmentEntry type to create
Example:
type.Type%3AexampleAssessmentEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more assessmentEntry record types
Example:
[ "type.Type%3AexampleAssessmentEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this assessmentEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment entry",
"linked": false
},
"description": {
"description": "The description of this assessment entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"enabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean",
"read-only": false,
"elementId": "AssessmentEntry.AssessmentEntry:enabled@base.url",
"existingValue": false,
"elementLabel": "Enabled",
"instructions": "Enter whether this assessment entry is enabled",
"linked": false
},
"disabled": {
"description": "Whether this assessment entry is administravely disabled. Administratively disabling overrides any applied enabler.",
"type": "boolean",
"read-only": false,
"elementId": "AssessmentEntry.AssessmentEntry:enabled@base.url",
"existingValue": false,
"elementLabel": "Enabled",
"instructions": "Enter whether this assessment entry is enabled",
"linked": false
},
"ruleId": {
"description": "An explicit Rule for this assessment entry.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:rule@base.url",
"existingValue": "",
"elementLabel": "Rule",
"instructions": "Select a Rule to apply to this assessment entry",
"linked": false
},
"dateCompleted": {
"description": "The completion date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:dateCompleted@dxtera.org",
"existingValue": "",
"elementLabel": "Date Completed",
"instructions": "Enter the date completed of this assessment entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this assessment entry.",
"linked": false
},
"courseId": {
"description": "The Course.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:course@dxtera.org",
"existingValue": null,
"elementLabel": "Course",
"instructions": "Enter the Id of the course for this assessment entry.",
"linked": false
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:grade@dxtera.org",
"existingValue": null,
"elementLabel": "Grade",
"instructions": "Enter the Id of the grade for this assessment entry.",
"linked": false
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:scoreScale@dxtera.org",
"existingValue": null,
"elementLabel": "Score Scale",
"instructions": "Enter the Id of the score scale for this assessment entry.",
"linked": false
},
"score": {
"description": "The cumulative score.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:score@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Score",
"instructions": "Enter the score of this assessment entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AssessmentEntry
Get a particular AssessmentEntry given its id.
Update a particular AssessmentEntry given its id.
Delete a particular AssessmentEntry given its id.
get /assessment-entries/{assessmentEntryId}
Get a particular AssessmentEntry given its id.
URI Parameters
- assessmentEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "grade", "scoreScale", "student", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "chronicle.AssessmentEntry:4022@base.url",
"uri": "http://base.url/open/campusapi/chronicle/assessmentEntry/chronicle.AssessmentEntry%3A4022%40base.url",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusTypeId": "type.Type:defaultAssessmentEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4022@base.url",
"studentId": "resource.Resource:5729@base.url",
"assessmentId": "assessment.Assessment:7021@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:987@base.url",
"courseId": "course.Course:9633@base.url",
"gradeId": "grading.Grade:9675@base.url",
"scoreScaleId": "grading.GradeSystem:2872@base.url",
"score": 3.14
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentEntry not found" }
put /assessment-entries/{assessmentEntryId}
Update a particular AssessmentEntry given its id.
URI Parameters
- assessmentEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AssessmentEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this assessment entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment entry for display.",
"type": "string"
},
"description": {
"description": "The description of this assessment entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"active": {
"description": "Whether this assessment entry is active. Active is true if operational is true and disabled is false, or enabled is true.",
"type": "boolean",
"readOnly": true
},
"enabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean"
},
"disabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean"
},
"operational": {
"description": "Whether this assessment entry is operational. This assessment entry is operational if any of the applied enablers are true.",
"type": "boolean",
"readOnly": true
},
"ruleId": {
"description": "An explicit Rule for this assessment entry.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this assessment entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"assessmentId": {
"description": "The assessment associated with this assessment entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateCompleted": {
"description": "The completion date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
},
"courseId": {
"description": "The Course.",
"type": "string",
"format": "osid-id"
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"format": "osid-id"
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"format": "osid-id"
},
"score": {
"description": "The cumulative score.",
"type": "number"
}
}
}
Example:
{
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8817@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:3267@base.url",
"courseId": "course.Course:8789@base.url",
"gradeId": "grading.Grade:6949@base.url",
"scoreScaleId": "grading.GradeSystem:1149@base.url",
"score": 3.14
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentEntry not found" }
delete /assessment-entries/{assessmentEntryId}
Delete a particular AssessmentEntry given its id.
URI Parameters
- assessmentEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AssessmentEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AssessmentEntry not found" }
Entity representing a AssessmentEntry form metadata for update
Get form metadata for updating an existing AssessmentEntry.
get /assessment-entries/{assessmentEntryId}/metadata
Get form metadata for updating an existing AssessmentEntry.
URI Parameters
- assessmentEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AssessmentEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this assessment entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this assessment entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this assessment entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this assessment entry",
"linked": false
},
"description": {
"description": "The description of this assessment entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this assessment entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this assessment entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this assessment entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"enabled": {
"description": "Whether this assessment entry is administravely enabled. Administratively enabling overrides any applied enabler.",
"type": "boolean",
"read-only": false,
"elementId": "AssessmentEntry.AssessmentEntry:enabled@base.url",
"existingValue": false,
"elementLabel": "Enabled",
"instructions": "Enter whether this assessment entry is enabled",
"linked": false
},
"disabled": {
"description": "Whether this assessment entry is administravely disabled. Administratively disabling overrides any applied enabler.",
"type": "boolean",
"read-only": false,
"elementId": "AssessmentEntry.AssessmentEntry:enabled@base.url",
"existingValue": false,
"elementLabel": "Enabled",
"instructions": "Enter whether this assessment entry is enabled",
"linked": false
},
"ruleId": {
"description": "An explicit Rule for this assessment entry.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AssessmentEntry.AssessmentEntry:rule@base.url",
"existingValue": "",
"elementLabel": "Rule",
"instructions": "Select a Rule to apply to this assessment entry",
"linked": false
},
"dateCompleted": {
"description": "The completion date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:dateCompleted@dxtera.org",
"existingValue": "",
"elementLabel": "Date Completed",
"instructions": "Enter the date completed of this assessment entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this assessment entry.",
"linked": false
},
"courseId": {
"description": "The Course.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:course@dxtera.org",
"existingValue": null,
"elementLabel": "Course",
"instructions": "Enter the Id of the course for this assessment entry.",
"linked": false
},
"gradeId": {
"description": "The Grade.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:grade@dxtera.org",
"existingValue": null,
"elementLabel": "Grade",
"instructions": "Enter the Id of the grade for this assessment entry.",
"linked": false
},
"scoreScaleId": {
"description": "The GradeSystem.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:scoreScale@dxtera.org",
"existingValue": null,
"elementLabel": "Score Scale",
"instructions": "Enter the Id of the score scale for this assessment entry.",
"linked": false
},
"score": {
"description": "The cumulative score.",
"type": "number",
"minimum": null,
"maximum": null,
"units": "",
"default": null,
"enum": [],
"elementId": "course.chronicle.AssessmentEntry:score@dxtera.org",
"existingValue": 3.14,
"elementLabel": "Score",
"instructions": "Enter the score of this assessment entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "assessmentEntry not found" }
/award-entries
Collection of AwardEntries in a system, federation of systems, or in a default CourseCatalog.
Get all AwardEntries in the system or default CourseCatalog.
Create a new AwardEntry in the default CourseCatalog.
get /award-entries
Get all AwardEntries in the system or default CourseCatalog.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "assessment", "student", "award", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAwardEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAwardEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAwardEntryType%40campusapi.org
- fromDate: (string)
Get all award-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all award-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- studentId: (string)
the id string to match a student.
Example:
resource.Resource%3A560%40base.url
- awardId: (string)
the id string to match a award.
Example:
recognition.Award%3A550%40base.url
- courseCatalogId: (string)
The id string to match a courseCatalog
Example:
course.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AwardEntry:736@base.url",
"uri": "http://base.url/open/campusapi/chronicle/awardEntry/chronicle.AwardEntry%3A736%40base.url",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusTypeId": "type.Type:defaultAwardEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAwardEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:736@base.url",
"studentId": "resource.Resource:7687@base.url",
"awardId": "recognition.Award:8211@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:866@base.url",
"courseId": "course.Course:1495@base.url",
"assessmentId": "assessment.Assessment:8403@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /award-entries
Create a new AwardEntry in the default CourseCatalog.
Query Parameters
- studentId: required(string)
the student of this award-entry.
Example:
resource.Resource%3A560%40base.url
- awardId: required(string)
the award of this award-entry.
Example:
recognition.Award%3A550%40base.url
- genusType: (string)
specify a particular awardEntry type to create
Example:
type.Type%3AexampleAwardEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more awardEntry record types
Example:
[ "type.Type%3AexampleAwardEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this awardEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AwardEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this award entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this award entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this award entry for display.",
"type": "string"
},
"description": {
"description": "The description of this award entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this award entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this award entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this award entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this award entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this award entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this award entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"awardId": {
"description": "The award associated with this award entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
},
"courseId": {
"description": "The Course.",
"type": "string",
"format": "osid-id"
},
"assessmentId": {
"description": "The Assessment.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:544@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:7264@base.url",
"courseId": "course.Course:2101@base.url",
"assessmentId": "assessment.Assessment:6475@base.url"
}
Query the collection of AwardEntries in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a AwardEntryQuery object.
post /award-entries/award-entry-query
Submit a query using a AwardEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "assessment", "student", "award", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AwardEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match AwardEntries with any end reason, false to match AwardEntries with no end reason",
"type": "boolean"
},
"matchStudentIds": {
"description": "List of student Ids for this query to match award entry that have a related student.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"studentQueries": {
"description": "StudentQueries to match the student. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAwardIds": {
"description": "List of award Ids for this query to match award entry that have a related award.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"awardQueries": {
"description": "AwardQueries to match the award. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchDateAwarded": {
"description": "Matches dateAwardeds between the given date range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"low": {
"description": "low date range",
"type": "string",
"format": "date-time"
},
"high": {
"description": "high date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyDateAwarded": {
"description": "Match dateAwardeds with any value. true to match AwardEntries with any date awarded, false to match ProgramOfferings with no date awarded",
"type": "boolean"
},
"matchProgramIds": {
"description": "List of Program Ids for this query to match program.",
"type": "array",
"items": {
"type": "object",
"properties": {
"programId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"programQueries": {
"description": "program.ProgramQueries to match the Program. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyProgram": {
"description": "Match program with any value. true to match AwardEntries with any program, false to match AwardEntries with no program",
"type": "boolean"
},
"matchCourseIds": {
"description": "List of Course Ids for this query to match course.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseQueries": {
"description": "course.CourseQueries to match the Course. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyCourse": {
"description": "Match course with any value. true to match AwardEntries with any course, false to match AwardEntries with no course",
"type": "boolean"
},
"matchAssessmentIds": {
"description": "List of Assessment Ids for this query to match assessment.",
"type": "array",
"items": {
"type": "object",
"properties": {
"assessmentId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"assessmentQueries": {
"description": "assessment.AssessmentQueries to match the Assessment. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyAssessment": {
"description": "Match assessment with any value. true to match AwardEntries with any assessment, false to match AwardEntries with no assessment",
"type": "boolean"
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AwardEntry:736@base.url",
"uri": "http://base.url/open/campusapi/chronicle/awardEntry/chronicle.AwardEntry%3A736%40base.url",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusTypeId": "type.Type:defaultAwardEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAwardEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:736@base.url",
"studentId": "resource.Resource:7687@base.url",
"awardId": "recognition.Award:8211@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:866@base.url",
"courseId": "course.Course:1495@base.url",
"assessmentId": "assessment.Assessment:8403@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AwardEntry form metadata.
Get form metadata for creating a new AwardEntry.
get /award-entries/metadata
Get form metadata for creating a new AwardEntry.
Query Parameters
- studentId: required(string)
the student of this metadatum.
Example:
resource.Resource%3A560%40base.url
- awardId: required(string)
the award of this metadatum.
Example:
recognition.Award%3A550%40base.url
- genusType: (string)
specify a particular awardEntry type to create
Example:
type.Type%3AexampleAwardEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more awardEntry record types
Example:
[ "type.Type%3AexampleAwardEntryRecordType%40campusapi.org", "..." ]
- courseCatalogId: (string)
specify in which course-catalog to create this awardEntry
Example:
chronicle.CourseCatalog%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AwardEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this award entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this award entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this award entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this award entry",
"linked": false
},
"description": {
"description": "The description of this award entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this award entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this award entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this award entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this award entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this award entry",
"linked": false
},
"endDate": {
"description": "The ending date of this award entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this award entry",
"linked": false
},
"endReasonId": {
"description": "The reason this award entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this award entry ended",
"linked": false
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:dateAwarded@dxtera.org",
"existingValue": "",
"elementLabel": "Date Awarded",
"instructions": "Enter the date awarded of this award entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this award entry.",
"linked": false
},
"courseId": {
"description": "The Course.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:course@dxtera.org",
"existingValue": null,
"elementLabel": "Course",
"instructions": "Enter the Id of the course for this award entry.",
"linked": false
},
"assessmentId": {
"description": "The Assessment.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:assessment@dxtera.org",
"existingValue": null,
"elementLabel": "Assessment",
"instructions": "Enter the Id of the assessment for this award entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a AwardEntry
Get a particular AwardEntry given its id.
Update a particular AwardEntry given its id.
Delete a particular AwardEntry given its id.
get /award-entries/{awardEntryId}
Get a particular AwardEntry given its id.
URI Parameters
- awardEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "assessment", "student", "award", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "chronicle.AwardEntry:736@base.url",
"uri": "http://base.url/open/campusapi/chronicle/awardEntry/chronicle.AwardEntry%3A736%40base.url",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusTypeId": "type.Type:defaultAwardEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAwardEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:736@base.url",
"studentId": "resource.Resource:7687@base.url",
"awardId": "recognition.Award:8211@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:866@base.url",
"courseId": "course.Course:1495@base.url",
"assessmentId": "assessment.Assessment:8403@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AwardEntry not found" }
put /award-entries/{awardEntryId}
Update a particular AwardEntry given its id.
URI Parameters
- awardEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "AwardEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this award entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this award entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this award entry for display.",
"type": "string"
},
"description": {
"description": "The description of this award entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this award entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this award entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this award entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this award entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this award entry ended.",
"type": "string",
"format": "osid-id"
},
"studentId": {
"description": "The student associated with this award entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"awardId": {
"description": "The award associated with this award entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time"
},
"programId": {
"description": "The Program.",
"type": "string",
"format": "osid-id"
},
"courseId": {
"description": "The Course.",
"type": "string",
"format": "osid-id"
},
"assessmentId": {
"description": "The Assessment.",
"type": "string",
"format": "osid-id"
}
}
}
Example:
{
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:544@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:7264@base.url",
"courseId": "course.Course:2101@base.url",
"assessmentId": "assessment.Assessment:6475@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AwardEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AwardEntry not found" }
delete /award-entries/{awardEntryId}
Delete a particular AwardEntry given its id.
URI Parameters
- awardEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The AwardEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "AwardEntry not found" }
Entity representing a AwardEntry form metadata for update
Get form metadata for updating an existing AwardEntry.
get /award-entries/{awardEntryId}/metadata
Get form metadata for updating an existing AwardEntry.
URI Parameters
- awardEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "AwardEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this award entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this award entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this award entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this award entry",
"linked": false
},
"description": {
"description": "The description of this award entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this award entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this award entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this award entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this award entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this award entry",
"linked": false
},
"endDate": {
"description": "The ending date of this award entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this award entry",
"linked": false
},
"endReasonId": {
"description": "The reason this award entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "AwardEntry.AwardEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this award entry ended",
"linked": false
},
"dateAwarded": {
"description": "The award date.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:dateAwarded@dxtera.org",
"existingValue": "",
"elementLabel": "Date Awarded",
"instructions": "Enter the date awarded of this award entry.",
"linked": false
},
"programId": {
"description": "The Program.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:program@dxtera.org",
"existingValue": null,
"elementLabel": "Program",
"instructions": "Enter the Id of the program for this award entry.",
"linked": false
},
"courseId": {
"description": "The Course.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:course@dxtera.org",
"existingValue": null,
"elementLabel": "Course",
"instructions": "Enter the Id of the course for this award entry.",
"linked": false
},
"assessmentId": {
"description": "The Assessment.",
"type": "string",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "course.chronicle.AwardEntry:assessment@dxtera.org",
"existingValue": null,
"elementLabel": "Assessment",
"instructions": "Enter the Id of the assessment for this award entry.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "awardEntry not found" }
/course-catalogs
Collection of CourseCatalogs in a system or federation of systems.
Get all CourseCatalogs.
Create a new CourseCatalog.
get /course-catalogs
Get all CourseCatalogs.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "provider", "branding", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleCourseCatalogType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleCourseCatalogType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleCourseCatalogType%40campusapi.org
- providerId: (string)
Id string to match provider.
Example:
resource.Resource%3A3007%40demo.dxtera.org
- programEntryId: (string)
Get course-catalogs mapped to this program-entry.
Example:
chronicle.ProgramEntry%3A1521%40demo.dxtera.org
- courseEntryId: (string)
Get course-catalogs mapped to this course-entry.
Example:
chronicle.CourseEntry%3A1404%40demo.dxtera.org
- credentialEntryId: (string)
Get course-catalogs mapped to this credential-entry.
Example:
chronicle.CredentialEntry%3A1872%40demo.dxtera.org
- assessmentEntryId: (string)
Get course-catalogs mapped to this assessment-entry.
Example:
chronicle.AssessmentEntry%3A1872%40demo.dxtera.org
- awardEntryId: (string)
Get course-catalogs mapped to this award-entry.
Example:
chronicle.AwardEntry%3A1287%40demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /course-catalogs
Create a new CourseCatalog.
Query Parameters
- genusType: (string)
specify a particular courseCatalog type to create
Example:
type.Type%3AexampleCourseCatalogType%40dxtera.org
- recordType: (array of )
specify support for one or more courseCatalog record types
Example:
[ "type.Type%3AexampleCourseCatalogRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseCatalog",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this course catalog, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course catalog, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course catalog for display.",
"type": "string"
},
"description": {
"description": "The description of this course catalog.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this course catalog. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course catalog. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this course catalog.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this course catalog. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this course catalog.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
}
Query the collection of CourseCatalogs in a system, federation of systems, or in a default courseCatalog by posting a Query object.
Submit a query using a CourseCatalogQuery object.
post /course-catalogs/course-catalog-query
Submit a query using a CourseCatalogQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: , or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseCatalogQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchProviderIds": {
"description": "List of provider Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"providerQueries": {
"description": "resource.ResourceQuery for provider. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
},
"matchAnyProvider": {
"description": "Match providers with any value. true to match CourseCatalog with any provider, false to match CourseCatalog with no provider",
"type": "boolean"
}
},
"matchBrandingIds": {
"description": "List of branding asset Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"brandingQueries": {
"description": "repository.AssetQuery for branding. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyBranding": {
"description": "Match brandingss with any value. true to match CourseCatalog with any branding, false to match CourseCatalog with no branding",
"type": "boolean"
},
"matchlicenses": {
"description": "List of license strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"license": {
"description": "license to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchCourseCatalogIds": {
"description": "List of CourseCatalog Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"courseCatalogId": {
"description": "Course Catalog id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"courseCatalogQueries": {
"description": "CourseCatalogQueries to match Course Catalog. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CourseCatalog form metadata.
Get form metadata for creating a new CourseCatalog.
get /course-catalogs/metadata
Get form metadata for creating a new CourseCatalog.
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CourseCatalog",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this course catalog, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course catalog, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course catalog for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this course catalog",
"linked": false
},
"description": {
"description": "The description of this course catalog.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this course catalog",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this course catalog. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course catalog. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this course catalog.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this course catalog",
"linked": false
},
"brandingIds": {
"description": "The branding of this course catalog. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "CourseCatalog.CourseCatalog:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this course catalog",
"linked": false
},
"license": {
"description": "The licensing that applies to this course catalog.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this course catalog",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
The root CourseCatalogs in the CourseCatalog hierarchy. A node with no parents is an orphan. While all CourseCatalog Ids are known to the hierarchy, an orphan does not appear in the hierarchy unless explicitly added as a root node or child of another node.
Get all root root-course-catalog
get /course-catalogs/root-course-catalog
Get all root root-course-catalog
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a CourseCatalog
Get a particular CourseCatalog given its id.
Update a particular CourseCatalog given its id.
Delete a particular CourseCatalog given its id.
get /course-catalogs/{courseCatalogId}
Get a particular CourseCatalog given its id.
URI Parameters
- courseCatalogId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseCatalog not found" }
put /course-catalogs/{courseCatalogId}
Update a particular CourseCatalog given its id.
URI Parameters
- courseCatalogId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "CourseCatalog",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this course catalog, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course catalog, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course catalog for display.",
"type": "string"
},
"description": {
"description": "The description of this course catalog.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this course catalog. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course catalog. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this course catalog.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this course catalog. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this course catalog.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CourseCatalog has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseCatalog not found" }
delete /course-catalogs/{courseCatalogId}
Delete a particular CourseCatalog given its id.
URI Parameters
- courseCatalogId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The CourseCatalog has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "CourseCatalog not found" }
Entity representing a CourseCatalog form metadata for update
Get form metadata for updating an existing CourseCatalog.
get /course-catalogs/{courseCatalogId}/metadata
Get form metadata for updating an existing CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "CourseCatalog",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this course catalog, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this course catalog, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this course catalog for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this course catalog",
"linked": false
},
"description": {
"description": "The description of this course catalog.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this course catalog",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this course catalog. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this course catalog. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this course catalog.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this course catalog",
"linked": false
},
"brandingIds": {
"description": "The branding of this course catalog. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "CourseCatalog.CourseCatalog:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this course catalog",
"linked": false
},
"license": {
"description": "The licensing that applies to this course catalog.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "CourseCatalog.CourseCatalog:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this course catalog",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "courseCatalog not found" }
Get child CourseCatalogs for the given CourseCatalog in the hierarchy.
get /course-catalogs/{courseCatalogId}/children
Get child CourseCatalogs for the given CourseCatalog in the hierarchy.
URI Parameters
- courseCatalogId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add CourseCatalog as child of the given CourseCatalog in the hierarchy.
Remove the given CourseCatalog as a child of the given CourseCatalog in the hierarchy.
put /course-catalogs/{courseCatalogId}/children/{childId}
Add CourseCatalog as child of the given CourseCatalog in the hierarchy.
URI Parameters
- courseCatalogId: required(string)
- childId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The child CourseCatalog has been added to the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "courseCatalog not found" }
delete /course-catalogs/{courseCatalogId}/children/{childId}
Remove the given CourseCatalog as a child of the given CourseCatalog in the hierarchy.
URI Parameters
- courseCatalogId: required(string)
- childId: required(string)
Get parent CourseCatalogs for the given CourseCatalog in the hierarchy.
get /course-catalogs/{courseCatalogId}/parents
Get parent CourseCatalogs for the given CourseCatalog in the hierarchy.
URI Parameters
- courseCatalogId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "course.CourseCatalog:8936@base.url",
"uri": "http://base.url/open/campusapi/course/courseCatalog/course.CourseCatalog%3A8936%40base.url",
"displayName": "Display Name of this CourseCatalog",
"description": "The description of this CourseCatalog",
"genusTypeId": "type.Type:defaultCourseCatalogType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseCatalogRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:CourseCatalog@base.url",
"license": "The license that applies to this CourseCatalog"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Get all ProgramEntries in this CourseCatalog
get /course-catalogs/{courseCatalogId}/program-entries
Get all ProgramEntries in this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "gpaScale", "student", "program", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleProgramEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleProgramEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleProgramEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.ProgramEntry:8111@base.url",
"uri": "http://base.url/open/campusapi/chronicle/programEntry/chronicle.ProgramEntry%3A8111%40base.url",
"displayName": "Display Name of this ProgramEntry",
"description": "The description of this ProgramEntry",
"genusTypeId": "type.Type:defaultProgramEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleProgramEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8111@base.url",
"studentId": "resource.Resource:3797@base.url",
"programId": "course.program.Program:3863@base.url",
"admissionDate": "2021-07-21T23:15:30.000Z",
"complete": true,
"termId": "course.Term:7370@base.url",
"creditScaleId": "grading.GradeSystem:6192@base.url",
"creditsEarned": 3.14,
"gpaScaleId": "grading.GradeSystem:2763@base.url",
"gpa": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given ProgramEntry to this CourseCatalog
Remove the given ProgramEntry from the CourseCatalog.
put /course-catalogs/{courseCatalogId}/program-entries/{programEntryId}
Add the given ProgramEntry to this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
- programEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "ProgramEntry has been added to CourseCatalog" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "ProgramEntry not found" }
delete /course-catalogs/{courseCatalogId}/program-entries/{programEntryId}
Remove the given ProgramEntry from the CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
- programEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "ProgramEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "ProgramEntry not found" }
Get all CourseEntries in this CourseCatalog
get /course-catalogs/{courseCatalogId}/course-entries
Get all CourseEntries in this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "term", "creditScale", "grade", "scoreScale", "student", "course", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleCourseEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleCourseEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleCourseEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CourseEntry:5236@base.url",
"uri": "http://base.url/open/campusapi/chronicle/courseEntry/chronicle.CourseEntry%3A5236%40base.url",
"displayName": "Display Name of this CourseEntry",
"description": "The description of this CourseEntry",
"genusTypeId": "type.Type:defaultCourseEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCourseEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5236@base.url",
"studentId": "resource.Resource:6553@base.url",
"courseId": "course.Course:2623@base.url",
"termId": "course.Term:6278@base.url",
"complete": true,
"creditScaleId": "grading.GradeSystem:9507@base.url",
"creditsEarned": 3.14,
"gradeId": "grading.Grade:4706@base.url",
"scoreScaleId": "grading.GradeSystem:3210@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given CourseEntry to this CourseCatalog
Remove the given CourseEntry from the CourseCatalog.
put /course-catalogs/{courseCatalogId}/course-entries/{courseEntryId}
Add the given CourseEntry to this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
- courseEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "CourseEntry has been added to CourseCatalog" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "CourseEntry not found" }
delete /course-catalogs/{courseCatalogId}/course-entries/{courseEntryId}
Remove the given CourseEntry from the CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
- courseEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "CourseEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "CourseEntry not found" }
Get all CredentialEntries in this CourseCatalog
get /course-catalogs/{courseCatalogId}/credential-entries
Get all CredentialEntries in this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "student", "credential", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleCredentialEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleCredentialEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleCredentialEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.CredentialEntry:4483@base.url",
"uri": "http://base.url/open/campusapi/chronicle/credentialEntry/chronicle.CredentialEntry%3A4483%40base.url",
"displayName": "Display Name of this CredentialEntry",
"description": "The description of this CredentialEntry",
"genusTypeId": "type.Type:defaultCredentialEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleCredentialEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4483@base.url",
"studentId": "resource.Resource:7087@base.url",
"credentialId": "course.program.Credential:1492@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:1925@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given CredentialEntry to this CourseCatalog
Remove the given CredentialEntry from the CourseCatalog.
put /course-catalogs/{courseCatalogId}/credential-entries/{credentialEntryId}
Add the given CredentialEntry to this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
- credentialEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "CredentialEntry has been added to CourseCatalog" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "CredentialEntry not found" }
delete /course-catalogs/{courseCatalogId}/credential-entries/{credentialEntryId}
Remove the given CredentialEntry from the CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
- credentialEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "CredentialEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "CredentialEntry not found" }
Get all AssessmentEntries in this CourseCatalog
get /course-catalogs/{courseCatalogId}/assessment-entries
Get all AssessmentEntries in this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "grade", "scoreScale", "student", "assessment", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAssessmentEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAssessmentEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAssessmentEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AssessmentEntry:4022@base.url",
"uri": "http://base.url/open/campusapi/chronicle/assessmentEntry/chronicle.AssessmentEntry%3A4022%40base.url",
"displayName": "Display Name of this AssessmentEntry",
"description": "The description of this AssessmentEntry",
"genusTypeId": "type.Type:defaultAssessmentEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAssessmentEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:4022@base.url",
"studentId": "resource.Resource:5729@base.url",
"assessmentId": "assessment.Assessment:7021@base.url",
"dateCompleted": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:987@base.url",
"courseId": "course.Course:9633@base.url",
"gradeId": "grading.Grade:9675@base.url",
"scoreScaleId": "grading.GradeSystem:2872@base.url",
"score": 3.14
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given AssessmentEntry to this CourseCatalog
Remove the given AssessmentEntry from the CourseCatalog.
put /course-catalogs/{courseCatalogId}/assessment-entries/{assessmentEntryId}
Add the given AssessmentEntry to this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
- assessmentEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentEntry has been added to CourseCatalog" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentEntry not found" }
delete /course-catalogs/{courseCatalogId}/assessment-entries/{assessmentEntryId}
Remove the given AssessmentEntry from the CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
- assessmentEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AssessmentEntry not found" }
Get all AwardEntries in this CourseCatalog
get /course-catalogs/{courseCatalogId}/award-entries
Get all AwardEntries in this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "program", "course", "assessment", "student", "award", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleAwardEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleAwardEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleAwardEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "chronicle.AwardEntry:736@base.url",
"uri": "http://base.url/open/campusapi/chronicle/awardEntry/chronicle.AwardEntry%3A736%40base.url",
"displayName": "Display Name of this AwardEntry",
"description": "The description of this AwardEntry",
"genusTypeId": "type.Type:defaultAwardEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleAwardEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:736@base.url",
"studentId": "resource.Resource:7687@base.url",
"awardId": "recognition.Award:8211@base.url",
"dateAwarded": "2021-07-21T23:15:30.000Z",
"programId": "course.program.Program:866@base.url",
"courseId": "course.Course:1495@base.url",
"assessmentId": "assessment.Assessment:8403@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given AwardEntry to this CourseCatalog
Remove the given AwardEntry from the CourseCatalog.
put /course-catalogs/{courseCatalogId}/award-entries/{awardEntryId}
Add the given AwardEntry to this CourseCatalog
URI Parameters
- courseCatalogId: required(string)
- awardEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AwardEntry has been added to CourseCatalog" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AwardEntry not found" }
delete /course-catalogs/{courseCatalogId}/award-entries/{awardEntryId}
Remove the given AwardEntry from the CourseCatalog.
URI Parameters
- courseCatalogId: required(string)
- awardEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "AwardEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "AwardEntry not found" }